> ## 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.

# XGameUiShowMultiplayerActivityGameInviteAsync

> XGameUiShowMultiplayerActivityGameInviteAsync

# XGameUiShowMultiplayerActivityGameInviteAsync

此方法显示一个从请求方玩家的好友列表和建议的好友列表填充的选取器 UI，以便使用多人活动服务的游戏发送游戏邀请。

## 语法

```cpp theme={null}
HRESULT XGameUiShowMultiplayerActivityGameInviteAsync(
  XAsyncBlock * async,
  XUserHandle requestingUser
)
```

### 参数

*async*   \_In\_
类型：XAsyncBlock \*

指向传递给 [XAsyncRun](/reference/system/xasync/functions/xasyncrun) 的 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock) 的指针。

*requestingUser*   \_In\_\
类型：XUserHandle

发送邀请的用户的句柄。

## 备注

若要通过 UI 发送邀请，在使用 [XblMultiplayerActivitySetActivityAsync](/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync)（见上面的示例）设置活动之后，游戏应调用 [XGameUiShowMultiplayerActivityGameInviteAsync](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync) API 并传入请求方用户。它将使用游戏的当前活动，并使用其连接字符串和设置邀请玩家。

## 要求

**标头：** XGameUI.h

**库：** xgameruntime.lib

**支持的平台：** Windows、Steam Deck、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[XGameUI 成员](/reference/system/xgameui/xgameui_members)


## Related topics

- [XGameUiShowMultiplayerActivityGameInviteUiCallback](/zh-CN/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteuicallback.md)
- [XGameUiShowMultiplayerActivityGameInviteResult](/zh-CN/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteresult.md)
- [XGameUiSetMultiplayerActivityGameInviteUiResponse](/zh-CN/reference/system/xgameui/functions/xgameuisetmultiplayeractivitygameinviteuiresponse.md)
- [Multiplayer Activity 示例代码](/zh-CN/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)
- [XGameUiUiCallbacks](/zh-CN/reference/system/xgameui/structs/xgameuiuicallbacks.md)