Skip to main content

XblMultiplayerManagerLobbySessionAddLocalUser

将 XBOX 用户加入到大厅会话。

语法

参数

user   _In_
类型:XblUserHandle
加入大厅会话的用户的用户句柄。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

此函数将创建新的大厅会话,并将 user 中指定的 XBOX 用户添加到会话中。随后的用户将作为辅助用户被添加到新托管的大厅会话中。只有在将第一个本地用户添加到大厅会话之后,才能发送邀请、设置会话属性以及访问大厅会话的成员。
此函数的结果作为多人游戏事件传递,事件类型设置为 XblMultiplayerEventType::JoinLobbyCompleted。你可以调用 XblMultiplayerManagerDoWork 检索多人游戏事件。
尝试加入大厅会话时,如果服务器已满,服务将返回 HTTP_E_STATUS_BAD_REQUEST
加入后,你可以通过调用 XblMultiplayerManagerLobbySessionSetSynchronizedProperties 设置大厅会话的属性,或者如果大厅会话尚无主机,你可以通过调用 XblMultiplayerManagerLobbySessionSetSynchronizedHost 设置大厅会话的主机。
你还可以通过调用 XblMultiplayerManagerLobbySessionInviteUsersXblMultiplayerManagerLobbySessionInviteFriends 向另一个用户发送邀请。如果你不需要大厅会话,并且你没有通过调用此函数添加本地用户,你可以改为调用 XblMultiplayerManagerJoinGame 并指定要加入游戏的用户列表。

要求

头文件: multiplayer_manager_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_manager_c
XblMultiplayerManagerJoinability
XblMultiplayerManagerJoinGameFromLobby
最后修改于 2026年8月24日