将 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