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

# XblMultiplayerSendInvitesAsync

> XblMultiplayerSendInvitesAsync

# XblMultiplayerSendInvitesAsync

邀請指定的使用者加入工作階段。這會使用標準邀請文字向每位受邀使用者顯示通知。如果使用者接受該通知，就會啟動該遊戲。

## 語法

```cpp theme={null}
HRESULT XblMultiplayerSendInvitesAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerSessionReference* sessionReference,  
         const uint64_t* xuids,  
         size_t xuidsCount,  
         uint32_t titleId,  
         const char* contextStringId,  
         const char* customActivationContext,  
         XAsyncBlock* async  
)  
```

### 參數

*xblContext*   \_In\_\
類型：[XblContextHandle](/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

本機使用者的 XBOX Live 內容。

*sessionReference*   \_In\_\
類型：[XblMultiplayerSessionReference\*](/zh-TW/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

XblMultiplayerSessionReference 物件，代表目標使用者將受邀加入的工作階段。

*xuids*   \_In\_\
類型：uint64\_t\*

將受邀的 Xbox 使用者識別碼清單。

*xuidsCount*   \_In\_\
類型：size\_t

xuids 陣列的大小。

*titleId*   \_In\_\
類型：uint32\_t

受邀使用者為了加入工作階段而將啟動之遊戲的識別碼。

*contextStringId*   \_In\_opt\_z\_\
類型：char\*

自訂內容字串識別碼。此字串識別碼是在 XBOX Live 擷取期間定義，用來識別標準邀請文字之外的額外邀請文字。識別碼字串必須加上 " /// " 前置詞。如果不想在邀請中加入自訂字串，請傳遞 nullptr。

*customActivationContext*   \_In\_opt\_z\_\
類型：char\*

啟用內容字串。由遊戲定義的字串，會傳遞給受邀的遊戲用戶端並依需要解譯。(選用)

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

此作業的 AsyncBlock。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 需求

**標頭：** multiplayer\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 概念文件

* [傳送邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## 另請參閱

[multiplayer\_c](/zh-TW/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [傳送邀請](/zh-TW/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [多人遊戲工作階段目錄概觀](/zh-TW/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [呼叫 XBOX 服務的最佳做法](/zh-TW/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)
- [多人遊戲工作](/zh-TW/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)