通过

XblMultiplayerManagerLobbySessionInviteFriends

  • 项目

显示标准 Xbox UI，允许用户选择好友或最近玩家并邀请他们加入游戏。

语法

HRESULT XblMultiplayerManagerLobbySessionInviteFriends(  
         XblUserHandle requestingUser,  
         const char* contextStringId,  
         const char* customActivationContext  
)

参数

requestingUser _In_
类型：XblUserHandle

正发送邀请的用户。

contextStringId _In_opt_z_
类型：char*

可选。 自定义内容字符串 ID，此字符串是在 Xbox Live 引入期间定义的，用于识别附加到标准邀请文字的自定义邀请文字。 ID 字符串必须以三个左斜线（“///”）为前缀。

customActivationContext _In_opt_z_
类型：char*

可选。 激活内容字符串，这是游戏定义的字符串，可传递给受邀请的游戏客户端并按游戏所需进行解释。

返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

备注

如果调用此函数，则当用户在标准 Xbox UI 中确认玩家选择时，多人游戏管理器会向所选玩家发送邀请。 如果所选玩家接受邀请，将通知游戏。 对于基于 GDK 的游戏，通过调用 XGameInviteRegisterForEvent 函数时指定的回调函数来通知游戏。 对于基于其他平台的游戏，将激活游戏。 有关详细信息，请参阅接受邀请。

要求

头文件：multiplayer_manager_c.h

图书馆： Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_manager_c
XblMultiplayerManagerJoinLobby
XblMultiplayerManagerLobbySessionAddLocalUser
XblMultiplayerManagerLobbySessionInviteUsers