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

# XGameUiShowStateShareAsync

> XGameUiShowStateShareAsync

# XGameUiShowStateShareAsync

*請注意，此方法在 2024 年 6 月 GDK 中為預覽版。*

此方法會顯示一個 UI，其中填入與所分享狀態相關的中繼資料，以及以網頁連結或直接邀請方式分享狀態的 UX 功能。

## 語法

```cpp theme={null}
HRESULT XGameUiShowStateShareAsync(
  XAsyncBlock * async,
  XUserHandle requestingUser,
  const char * linkToken
)
```

### 參數

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

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

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

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

*linkToken*   \_In\_z\_\
類型：const char \*

參考要分享之狀態的 linkToken。

## 備註

若要透過 UI 分享狀態，在建立狀態及對應的連結之後，遊戲應呼叫 [XGameUiShowStateShareAsync](/zh-TW/reference/system/xgameui/functions/xgameuishowstateshareasync) API，並傳入要求的使用者以及在為該狀態建立連結時所取得的連結權杖。使用 PlayFab 是建立狀態和連結的一種方式，如需詳細資訊，請洽詢您的 Microsoft 代表。

## 需求

**標頭：** XGameUI.h

**程式庫：** xgameruntime.lib

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

## 另請參閱

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


## Related topics

- [XGameUiShowStateShareAsync](/reference/system/xgameui/functions/xgameuishowstateshareasync.md)
- [XGameUiShowStateShareResult](/reference/system/xgameui/functions/xgameuishowstateshareresult.md)