> ## 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，其中填入要求玩家的好友清單和建議好友清單，以便為使用 Multiplayer Activity 服務的遊戲發送遊戲邀請。

## 語法

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

### 參數

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

指向傳遞給 [XAsyncRun](/zh-TW/reference/system/xasync/functions/xasyncrun) 之 [XAsyncBlock](/zh-TW/reference/system/xasync/structs/xasyncblock) 的指標。

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

發送邀請之使用者的控制代碼。

## 備註

若要透過 UI 發送邀請，在使用 [XblMultiplayerActivitySetActivityAsync](/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/functions/xblmultiplayeractivitysetactivityasync) 設定活動之後 (請參閱上述範例)，遊戲應呼叫 [XGameUiShowMultiplayerActivityGameInviteAsync](/zh-TW/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync) API 並傳入要求的使用者。它會使用遊戲目前的活動，並使用其連線字串和設定來邀請玩家。

## 需求

**標頭：** XGameUI.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

[XGameUI 成員](/zh-TW/reference/system/xgameui/xgameui_members)


## Related topics

- [XGameUiShowMultiplayerActivityGameInviteAsync](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteasync.md)
- [XGameUiShowMultiplayerActivityGameInviteUiCallback](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteuicallback.md)
- [XGameUiShowMultiplayerActivityGameInviteResult](/reference/system/xgameui/functions/xgameuishowmultiplayeractivitygameinviteresult.md)
- [XGameUiSetMultiplayerActivityGameInviteUiResponse](/ja-jp/reference/system/xgameui/functions/xgameuisetmultiplayeractivitygameinviteuiresponse.md)