nn::nex::RankingClient::GetCachedTopXRankings Member Function

Syntax

qBool GetCachedTopXRankings(
     ProtocolCallContext * pContext,
     const qVector< qUnsignedInt32 > & categories,
     const qVector< RankingOrderParam > & orderParams,
     qVector< RankingCachedResult > * pResults
);

Parameters

Name Description
in pContext The call context.
in categories Category.
in orderParams Parameters for calculating the order.
out pResults The obtained result of rankings. If no elements are found, a list with a size of 0 is stored in the specified location.

Return Values



Value Description
true RMC call initialization succeeded.
false Failure.

Description

Gets multiple cached top ranking lists up to the predefined length.

This function gets rankings that are cached on the server for up to five minutes. Because of this, the access count is recorded separately from the other ranking functions for the guideline check. The offset and length of RankingOrderParam are ignored. The offset value is set to 0 and the length uses the value configured in NMAS. The types of rankings that can be acquired simultaneously depend on the length. Up to a maximum of 100 combinations of length and categories can be acquired. Initially, rankings with 20 scores and 5 categories can be acquired simultaneously. A different cache is built for each combination of category and RankingOrderParam. Up to a maximum of 200 caches can be used across a game.

Rankings for communities that are user-generated or that have an uncertain number of users may increase. They do not benefit greatly from caching. Refrain from using this function with those communities.

Combinations are formed from categories and orderParams in the order the values are specified.

See Also

RankingCachedResult::LocalUpdate

Revision History

2014/03/20
Initial version.

CONFIDENTIAL