nn::nex::DataStoreClient::RateObject Member Function

Syntax

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

Parameters

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

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

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.

Revision History

2013/07/19
Initial version.

CONFIDENTIAL