virtual qBool RateObjectsWithPosting( ProtocolCallContext * pContext, const qVector< DataStoreRatingTarget > & targets, const DataStoreRateObjectParam & rateParam, const DataStorePostParam & postParam, qBool transactional = true, qVector< DataStoreRatingInfo > * pRatings = NULL, qVector< qResult > * pResults = NULL );
Name | Description | |
---|---|---|
in | pContext | Call information. |
in | targets | Target to rate. |
in | rateParam | Rating setting parameter. |
in | postParam | Initial 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 | Only entered if transactional is false for the results indicating success or not. (Optional.) |
Value | Description |
---|---|
true | RMC call initialization succeeded. |
false | Failure. |
Rates a batch of data. If there is no data, initializes using the specified value and rates it. You can specify the rating or the initial value, but not both.
DataStoreRateObjectParam
objects can be specified individually. If the initial values do not exist, they can be configured using DataStorePostParam
. Up to 16 sets of metadata can be processed in a single batch process. The pRatings and pResult parameters store the results of the processing on the specified targets in the same order they appear in targets.
Use the DataStorePreparePostParam::SetRatingSetting
function in the postParam element to initialize the rating. Specify the initial values of all of the slots required for initialization to the SetRatingSetting
function. After initialization, the results if unused slots were reinitialized is QERROR(DataStore, InvalidArgument)
.
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