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

Syntax

virtual qBool RateObject(
     ProtocolCallContext * pContext,
     const DataStoreRatingTarget & target,
     const DataStoreRateObjectParam & param,
     DataStoreRatingInfo * pRating
);

Parameters

Name Description
in pContext Call information.
in target Target to rate.
in param The setting parameter.
out pRating Ratings information after rating. Specify NULL if not needed.

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Rates data.

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

2012/10/23
Added that only a person who has access rights can rate.
2012/08/06
Added a note about the QERROR(DataStore, OperationNotAllowed) case.
2012/07/04
Access permissions are now checked.
2011/07/13
Initial version.

CONFIDENTIAL