XblMultiplayerManagerLobbySessionAddLocalUser

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

구문

HRESULT XblMultiplayerManagerLobbySessionAddLocalUser(  
         XblUserHandle user  
)  

매개 변수

user _In_
형식: XblUserHandle

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

반환 값

형식: HRESULT

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

비고

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

요구 사항

헤더: multiplayer_manager_c.h

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

참고 항목

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby