nn::nex::RankingClient::GetApproxOrder Member Function

Syntax

qBool GetApproxOrder(
     ProtocolCallContext * pContext,
     qUnsignedInt32 category,
     const RankingOrderParam & orderParam,
     qUnsignedInt32 score,
     qUnsignedInt32 * pOrder,
     UniqueId nexUniqueId = INVALID_UNIQUEID,
     qUnsignedInt32 principalId = INVALID_PRINCIPALID
);

Parameters

Name Description
in pContext The call context.
in category Category.
in orderParam Parameters for calculating the order.
in score Score.
out pOrder The estimated order.
in nexUniqueId The NEX unique ID.
in principalId The principal ID.

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Gets a predicted order based on the specified scores.

When a temporary score that is specified as an argument is registered, returns a predicted order for the rankings that is narrowed down by using the orderParam condition for the specified category.

The NEX unique ID and principal ID are used for calculating a more detailed order if there are people with the same score in the rankings, but in most cases use this function with just the default parameters.

This function does not actually register scores.

Note: If the results obtained are higher than RankingConstants::MAX_ACCURATE_ORDER, minor calculation errors may occur because of when the ranking data is retrieved.

Revision History

2012/03/08
Initial version.

CONFIDENTIAL