Skip to main content

XblMultiplayerSendInvitesAsync

邀请指定用户加入会话。这将向每个被邀请的用户显示带有标准邀请文本的通知。如果用户接受该通知,则将激活标题。

语法

参数

xblContext   _In_
类型:XblContextHandle
本地用户的 XBOX Live 上下文。 sessionReference   _In_
类型:XblMultiplayerSessionReference*
一个 XblMultiplayerSessionReference 对象,表示目标用户将被邀请加入的会话。 xuids   _In_
类型:uint64_t*
将被邀请的 XBOX 用户 ID 列表。 xuidsCount   _In_
类型:size_t
xuids 数组的大小。 titleId   _In_
类型:uint32_t
被邀请的用户将激活以加入会话的标题的 ID。 contextStringId   _In_opt_z_
类型:char*
自定义上下文字符串 ID。此字符串 ID 在 XBOX Live 引入期间定义,用于标识除标准邀请文本之外的附加邀请文本。ID 字符串必须以 ” /// ” 为前缀。如果不希望在邀请中添加自定义字符串,请传递 nullptr。 customActivationContext   _In_opt_z_
类型:char*
激活上下文字符串。由游戏定义的字符串,传递到被邀请的游戏客户端并按需解释。(可选) async   _In_
类型:XAsyncBlock*
此操作的 AsyncBlock。

返回值

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

要求

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

概念性文档

另请参阅

multiplayer_c
最后修改于 2026年8月24日