PFMultiplayerJoinLobbyAsServer
클라이언트 소유의 로비에 서버로 참가합니다.
구문
HRESULT PFMultiplayerJoinLobbyAsServer(
PFMultiplayerHandle handle,
const PFEntityKey* server,
const char* connectionString,
const PFLobbyServerJoinConfiguration* configuration,
void* asyncContext,
PFLobbyHandle* lobby
)
매개 변수
handle PFMultiplayerHandle
PFMultiplayer API 인스턴스의 핸들입니다.
server
PFEntityKey*
로비에 참가하는 서버의 PlayFab 엔티티 키입니다. 엔터티 형식은 "game_server"이어야 합니다.
connectionString char*
is null-terminated
서버가 로비에 참가하는 대 사용하는 연결 문자열입니다.
configuration
PFLobbyServerJoinConfiguration*
로비에 참가할 때 저장할 초기 서버 소유 데이터입니다.
asyncContext void*
선택 사항
완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.
lobby PFLobbyHandle*
선택적 라이브러리 할당 출력
이 작업이 완료되면 즉시 실행하기 위해 대기열에 작업을 넣는 데 사용할 수 있는 선택적 출력 로비 개체입니다.
반환 값
형식: HRESULT
호출이 성공한 경우 S_OK이고 그렇지 않은 경우 오류 코드입니다. 사람이 읽을 수 있는 형식의 오류 코드는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
이 기능을 사용하려면 PFLobby.h를 포함하기 전에 PFMULTIPLAYER_INCLUDE_SERVER_APIS를 정의해야 합니다.
비동기 작업입니다. 이 방법의 실행이 완료되었다고 해서 반드시 작업이 완료되는 것은 아닙니다.
성공적으로 완료되면 제목으로 PFLobbyUpdatedStateChange 및 PFLobbyUpdatedStateChange::serverUpdate 구성원이 적절히 채워지고 PFLobbyJoinLobbyAsServerCompletedStateChange::result 필드를 S_OK로 설정한 PFLobbyJoinLobbyAsServerCompletedStateChange를 생성합니다.
완료에 실패하면 제목으로 PFLobbyJoinLobbyAsServerCompletedStateChange가 제공되며, PFLobbyJoinLobbyAsServerCompletedStateChange::result 필드가 실패로 설정됩니다.
이 작업은 연결을 사용하는 클라이언트 소유의 로비로 제한됩니다.
요구 사항
헤더: PLobby.h