virtual qBool RateObject( ProtocolCallContext * pContext, const qVector< DataStoreRatingTarget > & targets, const qVector< DataStoreRateObjectParam > & params, const qBool transactional = true, qVector< DataStoreRatingInfo > * pRatings = NULL, qVector< qResult > * pResults = NULL );
Name | Description | |
---|---|---|
in | pContext | Call information. |
in | targets | Target to rate. |
in | params | The setting parameter. |
in | transactional | Specify true to process only if all succeed. |
out | pRatings | Ratings information after rating. Specify NULL if not needed. (Optional) |
out | pResults | Whether successful or not. (Can be omitted.) |
Value | Description |
---|---|
true | RMC call initialization succeeded. |
false | Failure. |
Rates a batch of data.
DataStoreRateObjectParam
objects can be specified individually. Up to 16 sets of metadata can be batch-processed. The params and targets arguments must contain the same number of elements. Each parameter is applied to the corresponding target in the order it appears. The pRatings and pResult parameters store the results of the processing on the specified targets in the same order they appear in targets.
To perform evaluation, the data slot must be initialized ahead of time. The rating is initialized by DataStorePreparePostParam::SetRatingSetting
when performing DataStoreClient::PostObject
. When this function is called to self-rate data that is prohibited from being self-rated or to rate data with a duplicate lock, it returns QERROR(DataStore, OperationNotAllowed)
. You can check whether a duplicate lock is present and check the lock period, by getting DataStoreRatingLog
with the DataStoreClient::GetRating
function. Only people who have access rights to the targeted data can rate it.
CONFIDENTIAL