> ## 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.

# PFMultiplayerJoinArrangedLobby

> Únase a un lobby de PlayFab mediante una cadena de disposición procedente de la creación de partidas u otro servicio; el lobby se inicializa a partir de la configuración si nadie se ha unido.

Se une a un lobby mediante una cadena de disposición proporcionada por otro servicio, como el de creación de partidas. Si todavía nadie se ha unido al lobby, el lobby se inicializa mediante los parámetros de configuración.

## Sintaxis

```cpp theme={null}
HRESULT PFMultiplayerJoinArrangedLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* newMember,  
    const char* arrangementString,  
    const PFLobbyArrangedJoinConfiguration* configuration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### Parámetros

**`handle`**   PFMultiplayerHandle

El identificador de la instancia de la API de PFMultiplayer.

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

La entidad de PlayFab local que se une al lobby.

**`arrangementString`**   char\*\
*is null-terminated*

La cadena de disposición que usa la entidad para unirse al lobby.

**`configuration`**   [PFLobbyArrangedJoinConfiguration\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyarrangedjoinconfiguration)

Los datos de configuración iniciales que se usan para inicializar el lobby, si todavía nadie se ha unido al lobby.

**`asyncContext`**   void\*\
*optional*

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

**`lobby`**   PFLobbyHandle\*\
*optional, library-allocated output*

El objeto de lobby de salida opcional, que se puede usar para poner en cola operaciones para su ejecución inmediata cuando se complete esta operación.

### Valor devuelto

Tipo: HRESULT

`S_OK` si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage).

## Comentarios

Esta es una operación asincrónica. Tras una finalización correcta, el título recibirá un [PFLobbyMemberAddedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange) seguido de un [PFLobbyJoinArrangedLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) con el campo [PFLobbyJoinArrangedLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) establecido en `S_OK`. Tras una finalización con error, el título recibirá un [PFLobbyJoinArrangedLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) con el campo [PFLobbyJoinArrangedLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) establecido en un error. <br /><br /> Cuando se usa la creación de partidas a través de esta biblioteca, [PFMatchmakingMatchDetails::lobbyArrangementString](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails) se puede usar con este método para unirse a un lobby con todos los usuarios que se han emparejado juntos.

## Requisitos

**Encabezado:** PFLobby.h

## Consulte también

[Miembros de PFLobby](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [Uso conjunto de lobby y matchmaking](/es/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
- [Migración de MPSD a PlayFab Multiplayer y MPA](/es/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [PFMatchmakingMatchDetails](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails.md)
- [PFLobbyStateChangeType](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbystatechangetype.md)
- [Información general de la API de C/C++ de PFMultiplayer - PFLobby.h](/es/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)