virtual qBool RateObjectWithPosting( ProtocolCallContext * pContext, const DataStoreRatingTarget & target, const DataStoreRateObjectParam & rateParam, const DataStorePostParam & postParam, DataStoreRatingInfo * pRating = NULL );
Name | Description | |
---|---|---|
in | pContext | Call information. |
in | target | Target to rate. |
in | rateParam | Rating setting parameter. |
in | postParam | Initial setting parameter. |
out | pRating | Ratings information after rating. Specify NULL if not needed. |
Value | Description |
---|---|
true | RMC call initialization succeeded. |
false | Failure. |
Rates data. If there is no data, initializes with the specified value and rates it.
Specifies the DataStoreRateObjectParam
when rating, and uses the DataStorePostParam
to set the initial value when there is no data for rating. 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