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

# XblMatchmakingCreateMatchTicketAsync

> XblMatchmakingCreateMatchTicketAsync

# XblMatchmakingCreateMatchTicketAsync

サーバーにマッチメイキング リクエストを送信し、チケット ID を持つマッチ チケットを返します。結果を取得するには、完了時に XblMatchmakingCreateMatchTicketResult を呼び出します。

## 構文

```cpp theme={null}
HRESULT XblMatchmakingCreateMatchTicketAsync(  
         XblContextHandle xboxLiveContext,  
         XblMultiplayerSessionReference ticketSessionReference,  
         const char* matchmakingServiceConfigurationId,  
         const char* hopperName,  
         const uint64_t ticketTimeout,  
         XblPreserveSessionMode preserveSession,  
         const char* ticketAttributesJson,  
         XAsyncBlock* asyncBlock  
)  
```

### パラメーター

*xboxLiveContext*   \_In\_\
型: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

ローカル ユーザーの XBOX live コンテキスト。

*ticketSessionReference*   \_In\_\
型: [XblMultiplayerSessionReference](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

マッチに使用するマルチプレイヤー セッション。

*matchmakingServiceConfigurationId*   \_In\_\
型: char\*

マッチのサービス構成 ID。

*hopperName*   \_In\_\
型: char\*

ホッパーの名前。

*ticketTimeout*   \_In\_\
型: uint64\_t

プレイヤーがセッションに参加するのを待機する最大時間。

*preserveSession*   \_In\_\
型: [XblPreserveSessionMode](/reference/live/xsapi-c/matchmaking_c/enums/xblpreservesessionmode)

セッションを保持するかどうかを示します。

*ticketAttributesJson*   \_In\_\
型: char\*

セッションのチケット属性。(オプション)

*asyncBlock*   \_In\_\
型: XAsyncBlock\*

この操作の AsyncBlock。

### 戻り値

型: HRESULT

この API 操作の HRESULT 戻り値コード。

## 解説

マッチ チケット オブジェクトには、チケット ID や待機時間などのサーバーから返された情報が含まれます。また、チケット データ オブジェクトからのタイトル指定データのコピーも含まれます。

## REST 呼び出し

V103 POST /serviceconfigs/{serviceConfigId}/hoppers/{hopperName} を呼び出します

## 要件

**ヘッダー:** matchmaking\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

[matchmaking\_c](/reference/live/xsapi-c/matchmaking_c/matchmaking_c_members)


## Related topics

- [XblMatchmakingCreateMatchTicketResult](/ja-jp/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakingcreatematchticketresult.md)
- [MPSD から PlayFab Multiplayer と MPA への移行](/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [SmartMatch マッチメイキングの使用](/ja-jp/services/xbox-services/multiplayer/matchmaking/concepts/live-matchmaking-how-tos.md)
- [Partner Center でのマッチメイキングの構成](/ja-jp/services/xbox-services/multiplayer/matchmaking/config/live-matchmaking-config.md)
- [マルチプレイヤータスク](/ja-jp/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)