XblMultiplayerManagerJoinLobby
XBOX 사용자를 로비 세션에 참가시킵니다.Syntax
Parameters
handleId _In_z_Type: char* 로비 세션에 대한 활동 핸들입니다. user _In_
Type: XblUserHandle 로비 세션에 참가하는 사용자의 사용자 핸들입니다.
Return value
Type: HRESULT 이 API 작업에 대한 HRESULT 반환 코드입니다.Remarks
이 함수는 user에 지정된 XBOX 사용자를 handleId에 지정된 로비 세션에 참가시킵니다. 로비 세션의 활동 핸들은 일반적으로 게임 초대 또는 XblMultiplayerGetActivitiesForUsersAsync를 호출하여 얻은 다른 사용자의 XblMultiplayerActivityDetails의HandleId 값에서 검색됩니다. 멀티플레이어 활동에 대한 자세한 내용은 Activities를 참조하세요. 이 함수의 결과는 이벤트 유형이
XblMultiplayerEventType::JoinLobbyCompleted로 설정된 멀티플레이어 이벤트로 전달됩니다. XblMultiplayerManagerDoWork를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다. 로비 세션에 참가하려고 할 때 서버가 가득 차면 서비스는
HTTP_E_STATUS_BAD_REQUEST를 반환합니다. 참가 후 XblMultiplayerManagerLobbySessionSetSynchronizedProperties를 호출하여 로비 세션의 속성을 설정하거나, 로비 세션에 아직 호스트가 없는 경우 XblMultiplayerManagerLobbySessionSetSynchronizedHost를 호출하여 로비 세션의 호스트를 설정할 수 있습니다.
또한 XblMultiplayerManagerLobbySessionInviteUsers 또는 XblMultiplayerManagerLobbySessionInviteFriends를 호출하여 다른 사용자에게 초대를 보낼 수 있습니다. 로비 세션이 필요하지 않고 XblMultiplayerManagerLobbySessionAddLocalUser를 호출하여 로컬 사용자를 추가하지 않은 경우, 대신 XblMultiplayerManagerJoinGame을 호출하고 게임에 참가할 사용자 목록을 지정할 수 있습니다.
Requirements
Header: multiplayer_manager_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.libConceptual documentation
See also
multiplayer_manager_cXblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby