XblMultiplayerManagerJoinGameFromLobby

로비 세션에 대한 새 게임 세션을 만들거나 로비 세션에 대한 기존 게임 세션이 있는 경우 기존 게임 세션에 참가합니다.

구문

HRESULT XblMultiplayerManagerJoinGameFromLobby(  
         const char* sessionTemplateName  
)  

매개 변수

sessionTemplateName _In_z_
형식: char*

기준으로 사용할 게임 세션에 대한 세션 템플릿 이름입니다.

반환 값

형식: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

비고

이 함수는 게임 세션이 아직 없는 경우 새 게임 세션을 만들고 로비 세션의 현재 멤버를 게임 세션에 추가합니다. 게임 세션이 이미 만들어진 후 새 사용자가 로비 세션에 참가하는 경우 이 함수는 로비 세션에서 전송 핸들을 사용하여 MPSD(멀티 플레이어 세션 디렉터리)에서 기존 게임 세션을 찾은 다음, 해당 전송 핸들을 사용하여 게임 세션에 새 사용자를 추가합니다. 자세한 내용은 멀티 플레이어 개념 개요를 참조하세요. 로비 세션이 없는 경우 이 함수를 호출하기 전에 XblMultiplayerManagerInitialize가 호출되지 않았기 때문에 오류가 발생하는 것일 수 있습니다. 매치 메이킹이 진행 중인 경우에도 오류가 발생합니다. 이 함수는 기존 로비 세션 속성을 해당 게임 세션으로 마이그레이션하지 않습니다.
이 함수의 결과는 이벤트 유형이 XblMultiplayerEventType::JoinGameCompleted(으)로 설정된 멀티 플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티 플레이어 이벤트를 검색할 수 있습니다.
로비 세션에 참가하려고 할 경우 서버가 가득 차면 서비스가 HTTP_E_STATUS_BAD_REQUEST을(를) 반환합니다.
참가한 후 XblMultiplayerManagerGameSessionSetProperties 또는 XblMultiplayerManagerGameSessionSetSynchronizedProperties를 호출하여 게임 세션의 속성을 설정하거나 할 수 있습니다. 또는 XblMultiplayerManagerGameSessionSetSynchronizedHost를 호출하여 게임 세션에 대한 호스트를 설정할 수 있습니다.

요구 사항

헤더: multiplayer_manager_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGame
XblMultiplayerManagerJoinLobby