PFMultiplayerJoinArrangedLobby - XBOX Game Development Documentation

매치메이킹과 같은 다른 서비스에서 제공된 배열 문자열을 사용하여 로비에 참여합니다. 아직 아무도 로비에 참여하지 않은 경우 구성 매개 변수를 사용하여 로비가 초기화됩니다.

구문

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*
null로 종료됨 엔터티가 로비에 참여하기 위해 사용하는 배열 문자열입니다. configuration PFLobbyArrangedJoinConfiguration* 아직 아무도 로비에 참여하지 않은 경우 로비를 초기화하는 데 사용되는 초기 구성 데이터입니다. asyncContext void*
선택 사항 이 호출과 완료 상태 변경을 연결하는 데 사용할 수 있는 선택적인 앱 정의 포인터 크기의 컨텍스트 값입니다. lobby PFLobbyHandle*
선택적, 라이브러리 할당 출력 이 작업의 완료 즉시 작업을 큐에 추가하는 데 사용할 수 있는 선택적 출력 로비 개체입니다.

반환 값

형식: HRESULT 호출이 성공한 경우 S_OK이고, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형태는 PFMultiplayerGetErrorMessage()를 통해 검색할 수 있습니다.

설명

이 작업은 비동기 작업입니다. 성공적으로 완료되면 타이틀에는 PFLobbyMemberAddedStateChange와 이어서 PFLobbyJoinArrangedLobbyCompletedStateChange::result 필드가 S_OK로 설정된 PFLobbyJoinArrangedLobbyCompletedStateChange가 제공됩니다. 완료에 실패하면 타이틀에는 PFLobbyJoinArrangedLobbyCompletedStateChange::result 필드가 실패로 설정된 PFLobbyJoinArrangedLobbyCompletedStateChange가 제공됩니다.

이 라이브러리를 통해 매치메이킹을 사용할 때 PFMatchmakingMatchDetails::lobbyArrangementString을 이 메서드와 함께 사용하여 매칭된 모든 사용자와 함께 로비에 참여할 수 있습니다.

요구 사항

헤더: PFLobby.h

참고 항목

PFLobby 멤버

​구문

​매개 변수

​반환 값

​설명

​요구 사항

​참고 항목

구문

매개 변수

반환 값

설명

요구 사항

참고 항목