Pular para o conteúdo principal
Ingressa em um lobby usando uma cadeia de caracteres de combinação fornecida por outro serviço, como o matchmaking. Se ninguém tiver ingressado no lobby ainda, o lobby será inicializado usando os parâmetros de configuração.

Sintaxe

Parâmetros

handle   PFMultiplayerHandle O identificador da instância da API PFMultiplayer. newMember   PFEntityKey* A entidade local do PlayFab que está ingressando no lobby. arrangementString   char*
terminada em nulo
A cadeia de caracteres de combinação usada pela entidade para ingressar no lobby. configuration   PFLobbyArrangedJoinConfiguration* Os dados de configuração iniciais usados para inicializar o lobby, se ninguém tiver ingressado no lobby ainda. asyncContext   void*
opcional
Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada. lobby   PFLobbyHandle*
opcional, saída alocada pela biblioteca
O objeto de lobby de saída opcional, que pode ser usado para enfileirar operações para execução imediata após a conclusão desta operação.

Valor retornado

Tipo: HRESULT S_OK se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de PFMultiplayerGetErrorMessage().

Comentários

Esta é uma operação assíncrona. Após a conclusão bem-sucedida, o título receberá uma PFLobbyMemberAddedStateChange seguida de uma PFLobbyJoinArrangedLobbyCompletedStateChange com o campo PFLobbyJoinArrangedLobbyCompletedStateChange::result definido como S_OK. Após uma conclusão com falha, o título receberá uma PFLobbyJoinArrangedLobbyCompletedStateChange com o campo PFLobbyJoinArrangedLobbyCompletedStateChange::result definido como uma falha.

Ao usar o matchmaking por meio desta biblioteca, PFMatchmakingMatchDetails::lobbyArrangementString pode ser usado com este método para ingressar em um lobby com todos os usuários que foram combinados.

Requisitos

Cabeçalho: PFLobby.h

Confira também

Membros do PFLobby
Última modificação em 8 de outubro de 2026