nn::nex::DataStoreClient::RateObjectsWithPosting Member Function

Syntax

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
);

Parameters

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.)

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

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.

Reference

RateObjectWithPosting

Revision History

2014/01/17
Initial version.

CONFIDENTIAL