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

# PFMultiplayerJoinLobbyAsServer

> PlayFab Multiplayer C++ SDK 로비 API를 통해 game_server 엔터티로 클라이언트 소유 PlayFab 로비에 참여하기 위한 PFMultiplayerJoinLobbyAsServer 참조입니다.

서버로서 클라이언트 소유 로비에 참여합니다.

## 구문

```cpp theme={null}
HRESULT PFMultiplayerJoinLobbyAsServer(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* server,  
    const char* connectionString,  
    const PFLobbyServerJoinConfiguration* configuration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### 매개 변수

**`handle`**   PFMultiplayerHandle

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

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

로비에 참여하는 서버의 PlayFab Entity Key입니다. 엔터티 형식은 "game\_server"여야 합니다.

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

서버가 로비에 참여하기 위해 사용하는 연결 문자열입니다.

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

로비에 참여할 때 저장될 초기 서버 소유 데이터입니다.

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

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

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 기능을 사용하려면 PFLobby.h를 포함하기 전에 PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS를 정의해야 합니다. <br /><br /> 이 작업은 비동기 작업입니다. 이 메서드의 실행 완료가 반드시 작업의 완료를 의미하지는 않습니다.   <br /><br /> 성공적으로 완료되면 타이틀에는 [PFLobbyUpdatedStateChange::serverUpdate](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange) 멤버가 적절하게 채워진 [PFLobbyUpdatedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange)와 [PFLobbyJoinLobbyAsServerCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange) 필드가 `S_OK`로 설정된 [PFLobbyJoinLobbyAsServerCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange)가 제공됩니다.   <br /><br /> 완료에 실패하면 타이틀에는 [PFLobbyJoinLobbyAsServerCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange) 필드가 실패로 설정된 [PFLobbyJoinLobbyAsServerCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange)가 제공됩니다.   <br /><br /> 이 작업은 연결을 사용하는 클라이언트 소유 로비로 제한됩니다.

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

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


## Related topics

- [PFLobbyJoinLobbyAsServerCompletedStateChange](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinlobbyasservercompletedstatechange.md)
- [PlayFab Multiplayer C++ SDK 릴리스 정보](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFLobbyGetLobbyId](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyid.md)
- [PFLobbyGetServerConnectionStatus](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetserverconnectionstatus.md)
- [로비 소유권](/ko/services/playfab/multiplayer/lobby/owner-requirements-and-privileges.md)