Edit

PFMultiplayerJoinArrangedLobby

Joins a lobby using an arrangement string provided by another service, such as matchmaking. If no one has joined the lobby yet, the lobby is initialized using the configuration parameters.

Syntax

HRESULT PFMultiplayerJoinArrangedLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* newMember,  
    const char* arrangementString,  
    const PFLobbyArrangedJoinConfiguration* configuration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  

Parameters

handle   PFMultiplayerHandle

The handle of the PFMultiplayer API instance.

newMember   const PFEntityKey*

The local PlayFab entity joining the lobby.

arrangementString   const char*
is null-terminated

The arrangement string used by the entity to join the lobby.

configuration   const PFLobbyArrangedJoinConfiguration*

The initial configuration data used to initialize the lobby, if no one has joined the lobby yet.

asyncContext   void*
optional

An optional, app-defined, pointer-sized context value that can be used to associate the completion state change with this call.

lobby   PFLobbyHandle*
optional, library-allocated output

An optional output lobby handle. If the call succeeds, the handle is available immediately, before the asynchronous operation completes, and you can use it to queue other operations on the lobby.

Return value

Type: HRESULT

S_OK if the call succeeded or an error code otherwise. The human-readable form of the error code can be retrieved via PFMultiplayerGetErrorMessage().

Remarks

This is an asynchronous operation. Upon successful completion, the title will be provided a PFLobbyMemberAddedStateChange followed by a PFLobbyJoinArrangedLobbyCompletedStateChange with the PFLobbyJoinArrangedLobbyCompletedStateChange::result field set to S_OK. Upon a failed completion, the title will be provided a PFLobbyJoinArrangedLobbyCompletedStateChange with the PFLobbyJoinArrangedLobbyCompletedStateChange::result field set to a failure.

When using matchmaking through this library, the PFMatchmakingMatchDetails::lobbyArrangementString can be used with this method to join a lobby with all of the users that have been matched together.

Before you call this function, call PFMultiplayerSetEntityToken for newMember. If no token is set for that entity, the call fails synchronously.

Requirements

Header: PFLobby.h

See also

PFLobby members