PFLobbyLeave
한 명 또는 모든 로컬 사용자에게 대기실에서 나가도록 요청합니다.
구문
HRESULT PFLobbyLeave(
PFLobbyHandle lobby,
const PFEntityKey* localUser,
void* asyncContext
)
매개 변수
lobby PFLobbyHandle
대기실의 핸들.
localUser
PFEntityKey*
선택 사항
특정 로컬 사용자가 대기실에서 나가야 하는지 여부를 나타내는 선택적 값입니다. 이 값이 nullptr이면 모든 로컬 사용자가 대기실에서 나가게 됩니다.
asyncContext void*
선택 사항
완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.
반환 값
형식: HRESULT
호출이 성공한 경우 S_OK이고 그렇지 않은 경우 오류 코드입니다. 사람이 읽을 수 있는 형식의 오류 코드는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
이 메서드는 비동기 작업을 큐에 대기시켜 한 명 또는 모든 로컬 사용자를 제거합니다. 완료되면 작업이 완료 되었음을 나타내는 PFLobbyLeaveLobbyCompletedStateChange가 제공됩니다.
이 메서드는 나가기 성공을 보장하지 않습니다. 네트워킹 또는 서비스 오류로 인해 작업이 실패할 수 있습니다. 나가기 시도가 실패할 때 다시 시도할 수 있는 경우 라이브러리는 나가기 작업을 계속 다시 시도합니다. 또는 로컬 클라이언트가 대기실에서 나가기가 요청된 로컬 구성원을 연결만 끊고 계속 구성원으로 둡니다. 이들은 다시 조인할 때까지 연결이 끊긴 구성원으로 남습니다.
이 메서드는 game_server 엔터티에서 호출할 수 없습니다.
요구 사항
헤더: PLobby.h