nn::nex::DataStoreLogicServerClient::RateObject Member Function

Syntax

virtual qBool RateObject(
     ProtocolCallContext * pContext,
     const qVector< DataStoreRatingTarget > & targets,
     const DataStoreRateObjectParam & param,
     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 param 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.

Up to 16 sets of metadata can be batch-processed. Parameters specified in param are applied to all targets specified in targets. 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

2011/07/13
Initial version.

CONFIDENTIAL