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

# PFLobbyLeave

> PlayFab Multiplayer C++ SDK 로비 API의 비동기 기능을 사용하여 하나 또는 모든 로컬 사용자가 PlayFab 로비를 이탈하도록 요청하기 위한 PFLobbyLeave 참조입니다.

하나 또는 모든 로컬 사용자에게 로비를 이탈하도록 요청합니다.

## 구문

```cpp theme={null}
HRESULT PFLobbyLeave(  
    PFLobbyHandle lobby,  
    const PFEntityKey* localUser,  
    void* asyncContext  
)  
```

### 매개 변수

**`lobby`**   PFLobbyHandle

로비의 핸들입니다.

**`localUser`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\
*선택 사항*

특정 로컬 사용자가 로비를 이탈해야 하는지 여부를 나타내는 선택적 값입니다. 이 값이 nullptr이면 모든 로컬 사용자가 로비를 이탈합니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 메서드는 하나 또는 모든 로컬 사용자를 로비에서 제거하는 비동기 작업을 큐에 추가합니다. 완료되면 작업이 완료되었음을 나타내는 [PFLobbyLeaveLobbyCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyleavelobbycompletedstatechange)가 제공됩니다. <br /><br /> 이 메서드는 이탈이 성공한다는 것을 보장하지 않습니다. 작업은 네트워킹 또는 서비스 오류로 인해 실패할 수 있습니다. 이탈 시도가 실패했지만 재시도 가능하면 라이브러리는 이탈 작업을 계속 재시도합니다. 그렇지 않으면 로컬 클라이언트는 요청된 로컬 멤버를 로비에서 연결 해제하지만 멤버로 남겨둡니다. 다시 참여할 때까지 연결이 끊긴 멤버로 유지됩니다.   <br /><br /> 이 메서드는 game\_server 엔터티에서 호출할 수 없습니다.

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

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


## Related topics

- [PFLobbyMemberRemovedStateChange](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberremovedstatechange.md)
- [PFLobbyMemberRemovedReason](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberremovedreason.md)
- [PFMultiplayerUninitialize](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayeruninitialize.md)
- [로비와 매치메이킹을 함께 사용](/ko/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
- [PFLobbyStateChangeType](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbystatechangetype.md)