XblMultiplayerActivitySendInvitesAsync
向 Xbox 用户 ID 发送邀请,以加入调用者的当前活动。
语法
HRESULT XblMultiplayerActivitySendInvitesAsync(
XblContextHandle xblContext,
const uint64_t* xuids,
size_t xuidsCount,
bool allowCrossPlatformJoin,
const char* connectionString,
XAsyncBlock* async
)
参数
xblContext _In_
类型:XblContextHandle
适用于本地用户的 Xbox Live 上下文。
xuids _In_
类型: uint64_t*
要邀请的 Xbox 用户 ID 的列表。
xuidsCount _In_
类型: size_t
xuids
阵列的大小。
allowCrossPlatformJoin _In_
类型: bool
如果游戏配置为跨平台邀请,将此参数设置为“true”,就会向游戏支持的所有平台端点发送邀请。 如果设置为“false”,邀请将仅发送到发送方的平台。 如果未配置跨平台邀请,邀请将始终仅发送到发送方的平台。
connectionString _In_opt_z_
类型: char*
(可选) 对等方使用于加入游戏的连接字符串。
async _In_
类型:XAsyncBlock*
此操作的 XAsyncBlock
。
返回值
类型:HRESULT
此 API 操作的 HRESULT 返回代码。
备注
若要获取异步操作的结果,请在 XAsyncBlock
回调中或 XAsyncBlock
完成后调用 XAsyncGetStatus。
若要了解如何使用此函数,请参阅 多玩家活动示例代码 中 邀请 部分的“发送邀请”。
有关多玩家活动的更多信息,请参阅 活动。
REST 调用
调用 POST /titles/{titleId}/invites
要求
标头: multiplayer_activity_c.h
图书馆: Microsoft.Xbox.Services.14x.GDK.C.lib