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