nn::nex::DataStoreLogicServerClient::RateObjectsWithPosting Member Function

Syntax

virtual qBool RateObjectsWithPosting(
     ProtocolCallContext * pContext,
     const qVector< DataStoreRatingTarget > & targets,
     const qVector< DataStoreRateObjectParam > & rateParams,
     const qVector< DataStorePostParam > & postParams,
     qBool transactional = true,
     qVector< DataStoreRatingInfo > * pRatings = NULL,
     qVector< qResult > * pResults = NULL
);

Parameters

Name Description
in pContext Call information.
in targets Target to rate.
in rateParams Rating setting parameter.
in postParams 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.

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 rateParams, postParams, and targets parameters 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.

Use the DataStorePreparePostParam::SetRatingSetting function in the postParams 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

2013/12/24
Initial version.

CONFIDENTIAL