> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerManagerFindMatch

> XblMultiplayerManagerFindMatch

# XblMultiplayerManagerFindMatch

マッチメイキング リクエストをサーバーに送信します。

## 構文

```cpp theme={null}
HRESULT XblMultiplayerManagerFindMatch(  
         const char* hopperName,  
         const char* attributesJson,  
         uint32_t timeoutInSeconds  
)  
```

### パラメーター

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

このリクエスト用のホッパーの名前。

*attributesJson*   \_In\_opt\_z\_\
型: char\*

省略可能。このリクエストのマッチ チケットの属性 (JSON 文字列)。

*timeoutInSeconds*   \_In\_\
型: uint32\_t

ユーザーがマッチに参加するのを待機する最大時間 (秒単位)。

### 戻り値

型: HRESULT

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

## 解説

この関数は、ロビー セッションのマッチメイキング リクエストを Multiplayer Manager (MPM) に送信します。この関数を使用するには、まずタイトルのサービス構成でホッパーを構成する必要があります。ホッパーは、SmartMatch がプレイヤーをマッチさせるために使用するルールを定義します。ホッパーの詳細については、「[マッチメイキングの概要](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview.md)」を参照してください。ロビー セッションが存在しない場合 (通常は [XblMultiplayerManagerInitialize](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize.md) が呼び出されていないため)、またはこの関数を呼び出す前にローカル ユーザーがロビー セッションに追加されていない場合、エラーが発生します。マッチメイキングが既に進行中の場合もエラーが発生します。\
この関数の結果は、イベント タイプが `XblMultiplayerEventType::FindMatchCompleted` に設定されたマルチプレイヤー イベントとして配信されます。[XblMultiplayerManagerDoWork](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) を呼び出して、マルチプレイヤー イベントを取得できます。

## 要件

**ヘッダー:** multiplayer\_manager\_c.h

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

## 関連項目

[multiplayer\_manager\_c](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerEstimatedMatchWaitTime](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)


## Related topics

- [XblMultiplayerManagerCancelMatch](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [Multiplayer Manager で SmartMatch を使用してマルチプレイヤー ゲームを見つけられるようにする](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Multiplayer Manager API の概要](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [multiplayer_manager_c](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)