PFMultiplayerClaimServerLobby
기존 서버 로비의 소유권을 요청합니다.
구문
HRESULT PFMultiplayerClaimServerLobby(
PFMultiplayerHandle handle,
const PFEntityKey* server,
const char* lobbyId,
void* asyncContext,
PFLobbyHandle* lobby
)
매개 변수
handle PFMultiplayerHandle
PFMultiplayer API 인스턴스의 핸들입니다.
server
PFEntityKey*
로비를 요청하는 게임 서버의 PlayFab 엔터티 키입니다. 엔터티 형식은 "game_server"이어야 합니다.
lobbyId char*
is null-terminated
요청할 로비의 ID입니다.
asyncContext void*
선택 사항
완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.
lobby PFLobbyHandle*
선택적 라이브러리 할당 출력
이 작업을 즉시 실행하기 위해 대기열에 작업을 추가하는 데 사용할 수 있는 선택적 출력 로비 개체입니다.
반환 값
형식: HRESULT
호출이 성공한 경우 S_OK이고 그렇지 않은 경우 오류 코드입니다. 사람이 읽을 수 있는 형식의 오류 코드는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
이 기능을 사용하려면 PFLobby.h를 포함하기 전에 PFMULTIPLAYER_INCLUDE_SERVER_APIS를 정의해야 합니다.
비동기 작업입니다. 성공적으로 완료되면 타이틀에 PFLobbyClaimServerLobbyCompletedStateChange::result 필드가 S_OK로 설정된 PFLobbyClaimServerLobbyCompletedStateChange가 제공됩니다. 완료에 실패하면 타이틀에 PFLobbyClaimServerLobbyCompletedStateChange::result 필드가 실패로 설정된 PFLobbyClaimServerLobbyCompletedStateChange가 제공됩니다.
이 작업은 주로 소유자가 연결을 끊었거나 연결을 끊을 서버 소유의 로비 소유권을 갖는 game_server 엔터티를 지원하기 위한 것입니다. 일반적으로 이는 다른 game_server 엔터티로 소유권을 마이그레이션하려는 game_server 엔터티 또는 크래시와 같은 로비 핸들에 대한 액세스 권한을 잃게 되는 심각한 오류 발생 후 자체 서버의 소유권을 복구해야 하는 game_server 엔터티에 흥미롭습니다.
게임 서버는 다른 game_server 엔터티가 현재 연결되어 있는 로비의 소유권을 요청할 수 없습니다.
요구 사항
헤더: PLobby.h