EOS_Sessions_RegisterPlayers

EOS API reference page for EOS_Sessions_RegisterPlayers

3 mins to read

This function is part of the Sessions Interface.

Remarks

Register a group of players with the session, allowing them to invite others or otherwise indicate they are part of the session for determining a full session

Return Value

  • EOS_Success if the register completes successfully

  • EOS_NoChange if the players to register registered previously

  • EOS_InvalidParameters if any of the options are incorrect

  • EOS_Sessions_OutOfSync if the session is out of sync and will be updated on the next connection with the backend

  • EOS_NotFound if a session to register players does not exist

  • EOS_LimitExceeded if registering the requested players would drive the total number of registered players beyond EOS_SESSIONS_MAXREGISTEREDPLAYERS (API Version <= 2)

  • EOS_Sessions_TooManyPlayers if registering the requested players would drive the total number of registered players beyond EOS_SESSIONS_MAXREGISTEREDPLAYERS (API Version > 2)

Parameters

EOS_Sessions_RegisterPlayers

Parameter Type And NameUsage Information
EOS_HSessions Handle
const EOS_Sessions_RegisterPlayersOptions* OptionsStructure containing information about the session and players to be registered
void* ClientDataArbitrary data that is passed back to you in the CompletionDelegate
const EOS_Sessions_OnRegisterPlayersCallback CompletionDelegateA callback that is fired when the registration operation completes, either successfully or in error

Callback Function Information

Because this function is asynchronous, it employs a callback of type EOS_Sessions_OnRegisterPlayersCallback to report the results of its operation.

Callback Remarks

Function prototype definition for callbacks passed to EOS_Sessions_RegisterPlayers

Callback Parameters

EOS_Sessions_OnRegisterPlayersCallback

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