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

另请参阅

multiplayer_activity_c