Skip to main content

XblMultiplayerManagerLobbySessionInviteUsers

邀请指定用户加入游戏,且不显示其他 UI。

语法

参数

user   _In_
类型:XblUserHandle
发送邀请的用户。 xuids   _In_
类型:uint64_t*
要邀请的 XBOX 用户 ID (XUID) 数组。 xuidsCount   _In_
类型:size_t
xuids 数组的大小。 contextStringId   _In_opt_z_
类型:char*
可选。自定义上下文字符串 ID,即在 XBOX Live 引入期间定义的字符串,用于标识添加到标准邀请文本中的自定义邀请文本。ID 字符串必须以三个斜杠字符(” /// “)作为前缀。 customActivationContext   _In_opt_z_
类型:char*
可选。激活上下文字符串,游戏定义的字符串,会传递到被邀请的游戏客户端并由游戏按需要进行解释。

返回值

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

备注

调用此函数时,多人游戏管理器会向选定的玩家发送邀请。如果选定玩家接受邀请,则会通知游戏。对于基于 GDK 的游戏,会通过调用调用 XGameInviteRegisterForEvent 函数时指定的回调函数来通知游戏。对于基于其他平台的游戏,游戏将会被激活。有关详细信息,请参阅接收邀请

要求

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

另请参阅

multiplayer_manager_c
XblMultiplayerManagerJoinLobby
XblMultiplayerManagerLobbySessionAddLocalUser
XblMultiplayerManagerLobbySessionInviteFriends
最后修改于 2026年8月24日