API reference
API reference
Select your platform
No SDKs available
No versions available

ovr_Challenges_GetEntriesByIds Function

Requests a block of challenge entries. Will return only entries matching the user IDs passed in. ovrMessage_Challenges_GetEntriesByIds will be generated in response.
First call ovr_Message_IsError() to check if an error occurred.
If no error occurred, the message will contain a payload of type ovrChallengeEntryArrayHandle. Extract the payload from the message handle with ovr_Message_GetChallengeEntryArray().

Signature

ovrRequest ovr_Challenges_GetEntriesByIds(ovrID challengeID, int limit, ovrLeaderboardStartAt startAt, ovrID *userIDs, unsigned int userIDLength)

Parameters

challengeID: ovrID The id of the challenge whose entries to return.
limit: int Defines the maximum number of entries to return.
startAt: ovrLeaderboardStartAt Defines whether to center the query on the user or start at the top of the challenge. If this is ovrLeaderboard_StartAtCenteredOnViewer or ovrLeaderboard_StartAtCenteredOnViewerOrTop, then the current user's ID will be automatically added to the query.
userIDs: ovrID * Defines a list of user ids to get entries for.
userIDLength: unsigned int The number of user IDs provided.

Returns