EOS_Leaderboards_QueryLeaderboardRanks

EOS API reference page for EOS_Leaderboards_QueryLeaderboardRanks

3 분 소요

This function is part of the Leaderboards Interface.

Remarks

Retrieves top leaderboard records by rank in the leaderboard matching the given leaderboard ID.

Return Value

  • EOS_Success if the operation completes successfully

  • EOS_InvalidParameters if any of the options are incorrect

Parameters

EOS_Leaderboards_QueryLeaderboardRanks

Parameter Type And NameUsage Information
EOS_HLeaderboards Handle
const EOS_Leaderboards_QueryLeaderboardRanksOptions* OptionsStructure containing information about the leaderboard records we're retrieving.
void* ClientDataArbitrary data that is passed back to you in the CompletionDelegate.
const EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallback CompletionDelegateThis function is called when the query operation completes.

Callback Function Information

Because this function is asynchronous, it employs a callback of type EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallback to report the results of its operation. See the EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallbackInfo page for more details, or check the [Callback Data] section below.

Callback Remarks

Function prototype definition for callbacks passed to EOS_Leaderboards_QueryLeaderboardRanks

Callback Parameters

EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallback

Parameter Type And NameUsage Information
const EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallbackInfo* DataA EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallbackInfo containing the output information and result

Callback Data

The EOS SDK passes the following data structure to the callback function:

EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallbackInfo

PropertyValue
EOS_EResult ResultCodeThe EOS_EResult code for the operation. EOS_Success indicates that the operation succeeded; other codes indicate errors.
void* ClientDataContext that was passed into EOS_Leaderboards_QueryLeaderboardRanks.

For more information, see the EOS_Leaderboards_OnQueryLeaderboardRanksCompleteCallbackInfo page.