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

# PFLobbyAddMember

> Referencia de PFLobbyAddMember para el SDK de C++ de PlayFab Multiplayer, que se usa para agregar un usuario local como nuevo miembro de un lobby existente creado o al que se unió el título.

Agrega un usuario local como miembro al lobby.

## Sintaxis

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

El identificador del lobby.

**`localUser`**   [PFEntityKey\*](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

La clave de entidad de PlayFab del usuario local que se agregará al lobby como miembro.

**`memberPropertyCount`**   uint32\_t\
*entrada en el intervalo `0,PFLobbyMaxMemberPropertyCount`*

El número de propiedades de miembro iniciales que se establecerán para este usuario cuando se una al lobby.

**`memberPropertyKeys`**   char\* const\*\
*matriz de entrada de tamaño `memberPropertyCount`*

Las claves de las propiedades de miembro iniciales que se establecerán para este usuario cuando se una al lobby.

**`memberPropertyValues`**   char\* const\*\
*matriz de entrada de tamaño `memberPropertyCount`*

Los valores de las propiedades de miembro iniciales que se establecerán para este usuario cuando se una al lobby.

**`asyncContext`**   void\*\
*opcional*

Un valor de contexto opcional, definido por la aplicación y del tamaño de un puntero, que puede usarse para asociar el cambio de estado de finalización con esta llamada.

### Valor devuelto

Tipo: HRESULT

`S_OK` si la llamada se realizó correctamente; de lo contrario, un código de error. La forma legible del código de error puede recuperarse mediante [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md).

## Comentarios

Se trata de una operación asincrónica. Tras una finalización correcta, el título recibirá un [PFLobbyMemberAddedStateChange](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md) seguido de un [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) con el campo [PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) establecido en `S_OK`. Tras una finalización con error, el título recibirá un [PFLobbyAddMemberCompletedStateChange](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) con el campo [PFLobbyAddMemberCompletedStateChange::result](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyaddmembercompletedstatechange.md) establecido en un hresult de error. \
\
 Este método se usa para agregar otra entidad local de PlayFab a un objeto de lobby preexistente. Dado que el objeto de lobby debe haberse creado ya mediante una llamada a [PFMultiplayerCreateAndJoinLobby](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby.md) o [PFMultiplayerJoinLobby](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md), este método es útil principalmente para escenarios con varios usuarios locales.   \
\
 Se trata de una operación asincrónica. El miembro agregado mediante este método no se reflejará en las listas devueltas por [PFLobbyGetMembers](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md) hasta que la operación asincrónica se complete correctamente y [PFMultiplayerStartProcessingLobbyStateChanges](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) proporcione una estructura `PFLobbyMemberAddedStateChange`.

## Requisitos

**Encabezado:** PFLobby.h

## Consulte también

[Miembros de PFLobby](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [PFLobbyMemberAddedStateChange](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md)
- [PFLobbyGetMemberProperty](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberproperty.md)
- [PFLobbyGetMemberPropertyKeys](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberpropertykeys.md)
- [PFLobbyDisconnectingStateChange](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbydisconnectingstatechange.md)
- [PFLobbyGetMemberConnectionStatus](https://docs.xbox.com/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)