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

> 매치메이킹 또는 다른 서비스에서 제공된 배열 문자열을 사용하여 PlayFab 로비에 참여합니다. 아무도 참여하지 않은 경우 구성으로부터 로비가 초기화됩니다.

매치메이킹과 같은 다른 서비스에서 제공된 배열 문자열을 사용하여 로비에 참여합니다. 아직 아무도 로비에 참여하지 않은 경우 구성 매개 변수를 사용하여 로비가 초기화됩니다.

## 구문

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

### 매개 변수

**`handle`**   PFMultiplayerHandle

PFMultiplayer API 인스턴스의 핸들입니다.

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

로비에 참여하는 로컬 PlayFab 엔터티입니다.

**`arrangementString`**   char\*\
*null로 종료됨*

엔터티가 로비에 참여하기 위해 사용하는 배열 문자열입니다.

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

아직 아무도 로비에 참여하지 않은 경우 로비를 초기화하는 데 사용되는 초기 구성 데이터입니다.

**`asyncContext`**   void\*\
*선택 사항*

이 호출과 완료 상태 변경을 연결하는 데 사용할 수 있는 선택적인 앱 정의 포인터 크기의 컨텍스트 값입니다.

**`lobby`**   PFLobbyHandle\*\
*선택적, 라이브러리 할당 출력*

이 작업의 완료 즉시 작업을 큐에 추가하는 데 사용할 수 있는 선택적 출력 로비 개체입니다.

### 반환 값

형식: HRESULT

호출이 성공한 경우 `S_OK`이고, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage)를 통해 검색할 수 있습니다.

## 설명

이 작업은 비동기 작업입니다. 성공적으로 완료되면 타이틀에는 [PFLobbyMemberAddedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange)와 이어서 [PFLobbyJoinArrangedLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) 필드가 `S_OK`로 설정된 [PFLobbyJoinArrangedLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange)가 제공됩니다. 완료에 실패하면 타이틀에는 [PFLobbyJoinArrangedLobbyCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange) 필드가 실패로 설정된 [PFLobbyJoinArrangedLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinarrangedlobbycompletedstatechange)가 제공됩니다. <br /><br /> 이 라이브러리를 통해 매치메이킹을 사용할 때 [PFMatchmakingMatchDetails::lobbyArrangementString](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingmatchdetails)을 이 메서드와 함께 사용하여 매칭된 모든 사용자와 함께 로비에 참여할 수 있습니다.

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

[PFLobby 멤버](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)