> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFLobbyAddMember

> Referência de PFLobbyAddMember do SDK C++ do PlayFab Multiplayer, usada para adicionar um usuário local como novo membro de um lobby existente criado ou ingressado pelo título.

Adiciona um usuário local como membro do lobby.

## Sintaxe

```cpp theme={null}
HRESULT PFLobbyAddMember(  
    PFLobbyHandle lobby,  
    const PFEntityKey* localUser,  
    uint32_t memberPropertyCount,  
    const char* const* memberPropertyKeys,  
    const char* const* memberPropertyValues,  
    void* asyncContext  
)  
```

### Parâmetros

**`lobby`**   PFLobbyHandle

O identificador do lobby.

**`localUser`**   [PFEntityKey\*](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

A chave de entidade do PlayFab do usuário local a ser adicionado ao lobby como membro.

**`memberPropertyCount`**   uint32\_t\
*entrada no intervalo `0,PFLobbyMaxMemberPropertyCount`*

O número de propriedades de membro iniciais a serem definidas para esse usuário quando ele ingressar no lobby.

**`memberPropertyKeys`**   char\* const\*\
*matriz de entrada de tamanho `memberPropertyCount`*

As chaves das propriedades de membro iniciais a serem definidas para esse usuário quando ele ingressar no lobby.

**`memberPropertyValues`**   char\* const\*\
*matriz de entrada de tamanho `memberPropertyCount`*

Os valores das propriedades de membro iniciais a serem definidas para esse usuário quando ele ingressar no lobby.

**`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.

### 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()](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentários

Esta é uma operação assíncrona. Após a conclusão bem-sucedida, o título receberá uma [PFLobbyMemberAddedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange) seguida de uma [PFLobbyAddMemberCompletedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange) com o campo [PFLobbyAddMemberCompletedStateChange::result](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange) definido como `S_OK`. Após uma conclusão com falha, o título receberá uma [PFLobbyAddMemberCompletedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange) com o campo [PFLobbyAddMemberCompletedStateChange::result](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange) definido como um hresult de falha. <br /><br /> Este método é usado para adicionar outra entidade local do PlayFab a um objeto de lobby preexistente. Como o objeto de lobby já deve ter sido criado por meio de uma chamada a [PFMultiplayerCreateAndJoinLobby](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby) ou [PFMultiplayerJoinLobby](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby), este método é útil principalmente em cenários com vários usuários locais.   <br /><br /> Esta é uma operação assíncrona. O membro adicionado por meio deste método não será refletido nas listas retornadas por [PFLobbyGetMembers](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers) até que a operação assíncrona seja concluída com êxito e uma struct `PFLobbyMemberAddedStateChange` seja fornecida por [PFMultiplayerStartProcessingLobbyStateChanges](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges).

## Requisitos

**Cabeçalho:** PFLobby.h

## Confira também

[Membros do PFLobby](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyMemberAddedStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)
- [PFLobbyGetMemberProperty](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberproperty.md)
- [PFLobbyGetMemberPropertyKeys](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)
- [PFLobbyDisconnectingStateChange](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbydisconnectingstatechange.md)
- [PFLobbyGetMemberConnectionStatus](/pt-BR/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)