XblMultiplayerManagerJoinLobby

Xbox 사용자를 로비 세션에 참가시킵니다.

구문

HRESULT XblMultiplayerManagerJoinLobby(  
         const char* handleId,  
         XblUserHandle user  
)  

매개 변수

handleId _In_z_
형식: char*

로비 세션에 대한 활동 핸들입니다.

user _In_
형식: XblUserHandle

로비 세션에 참가하는 사용자의 사용자 핸들입니다.

반환 값

형식: HRESULT

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

비고

이 함수는 사용자에 지정된 Xbox 사용자를 handleId로 지정된 로비 세션에 참가시킵니다. 로비 세션에 대한 활동 핸들은 일반적으로 게임 초대에서 또는 XblMultiplayerGetActivitiesForUsersAsync를 호출하여 다른 사용자의 XblMultiplayerActivityDetailsHandleId 값에서 불러옵니다. 멀티 플레이 활동에 대한 자세한 내용은 활동을 참조하세요.
이 함수의 결과는 이벤트 유형이 XblMultiplayerEventType::JoinLobbyCompleted로 설정된 멀티 플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티 플레이어 이벤트를 검색할 수 있습니다.
로비 세션에 참가하려고 할 경우 서버가 가득 차면 서비스가 HTTP_E_STATUS_BAD_REQUEST을(를) 반환합니다.
참가한 후 XblMultiplayerManagerLobbySessionSetSynchronizedProperties를 호출하여 로비 세션에 대한 속성을 설정하거나 로비 세션에 호스트가 아직 없는 경우 XblMultiplayerManagerLobbySessionSetSynchronizedHost를 호출하여 로비 세션에 대한 호스트를 설정할 수 있습니다.
XblMultiplayerManagerLobbySessionInviteUsers 또는 XblMultiplayerManagerLobbySessionInviteFriends를 호출하여 다른 사용자에게 초대를 보낼 수도 있습니다. 로비 세션이 필요하지 않고 XblMultiplayerManagerLobbySessionAddLocalUser를 호출하여 로컬 사용자를 추가하지 않은 경우 대신 XblMultiplayerManagerJoinGame을 호출하고 게임에 참가할 사용자 목록을 지정할 수 있습니다.

요구 사항

헤더: multiplayer_manager_c.h

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

참고 항목

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby