PFMultiplayerJoinArrangedLobby
매치 메이킹과 같은 다른 서비스에서 제공하는 정렬 문자열을 사용하여 로비에 참가합니다. 아직 로비에 참가한 사용자가 없는 경우 로비는 구성 매개 변수를 사용하여 초기화됩니다.
구문
HRESULT PFMultiplayerJoinArrangedLobby(
PFMultiplayerHandle handle,
const PFEntityKey* newMember,
const char* arrangementString,
const PFLobbyArrangedJoinConfiguration* configuration,
void* asyncContext,
PFLobbyHandle* lobby
)
매개 변수
handle PFMultiplayerHandle
PFMultiplayer API 인스턴스의 핸들입니다.
newMember
PFEntityKey*
대기실에 참가하는 로컬 PlayFab 엔터티입니다.
arrangementString char*
is null-terminated
엔터티가 대기실에 참가하는 데 사용하는 정렬 문자열입니다.
configuration
PFLobbyArrangedJoinConfiguration*
대기실에 아직 참가한 사람이 없는 경우 대기실을 초기화하는 데 사용되는 초기 구성 데이터입니다.
asyncContext void*
선택 사항
완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.
lobby PFLobbyHandle*
선택적 라이브러리 할당 출력
이 작업을 즉시 실행하기 위해 대기열에 작업을 추가하는 데 사용할 수 있는 선택적 출력 로비 개체입니다.
반환 값
형식: HRESULT
호출이 성공한 경우 S_OK이고 그렇지 않은 경우 오류 코드입니다. 사람이 읽을 수 있는 형식의 오류 코드는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.
설명
비동기 작업입니다. 성공적으로 완료되면 타이틀에 PFLobbyMemberAddedStateChange가 제공되고 뒤에 PFLobbyJoinArrangedLobbyCompletedStateChange::result 필드가 S_OK(으)로 설정된 PFLobbyJoinArrangedLobbyCompletedStateChange가 제공됩니다. 완료가 실패하면 타이틀에 PFLobbyJoinArrangedLobbyCompletedStateChange::result 필드가 실패로 설정된 PFLobbyJoinArrangedLobbyCompletedStateChange가 제공됩니다.
이 라이브러리를 통해 매치 메이킹을 사용하는 경우 이 메서드와 함께 PFMatchmakingMatchDetails::lobbyArrangementString을 사용하여 함께 매치된 모든 사용자와 함께 로비에 참가할 수 있습니다.
요구 사항
헤더: PLobby.h