> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerManagerLobbySessionInviteFriends

> XblMultiplayerManagerLobbySessionInviteFriends

# XblMultiplayerManagerLobbySessionInviteFriends

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

## 语法

```cpp theme={null}
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](/reference/system/xgameinvite/functions/xgameinviteregisterforevent) 函数时指定的回调函数来通知游戏。对于基于其他平台的游戏，游戏将会被激活。有关详细信息，请参阅[接收邀请](/services/xbox-services/multiplayer/invites/how-to/live-invites-receive)。

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerJoinLobby](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby)\
[XblMultiplayerManagerLobbySessionAddLocalUser](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser)\
[XblMultiplayerManagerLobbySessionInviteUsers](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers)


## Related topics

- [XblMultiplayerManagerLobbySessionInviteUsers](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionRemoveLocalUser](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionremovelocaluser.md)
- [使用 Multiplayer Manager 发送游戏邀请](/zh-CN/services/xbox-services/multiplayer/mpm/how-to/live-send-game-invites.md)
- [XblMultiplayerManagerLobbySessionAddLocalUser](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionaddlocaluser.md)
- [XblMultiplayerManagerJoinLobby](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerjoinlobby.md)