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

# 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 がプレイヤーをマッチさせるために使用するルールを定義します。ホッパーの詳細については、「[マッチメイキングの概要](/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview)」を参照してください。ロビー セッションが存在しない場合 (通常は [XblMultiplayerManagerInitialize](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize) が呼び出されていないため)、またはこの関数を呼び出す前にローカル ユーザーがロビー セッションに追加されていない場合、エラーが発生します。マッチメイキングが既に進行中の場合もエラーが発生します。<br />この関数の結果は、イベント タイプが `XblMultiplayerEventType::FindMatchCompleted` に設定されたマルチプレイヤー イベントとして配信されます。[XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) を呼び出して、マルチプレイヤー イベントを取得できます。

## 要件

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

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

## 関連項目

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerEstimatedMatchWaitTime](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime)


## Related topics

- [XblMultiplayerManagerCancelMatch](/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [SmartMatch と MPM によるマルチプレイヤー マッチメイキング](/ja-jp/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Multiplayer Manager API の概要](/ja-jp/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblMultiplayerEventType](/ja-jp/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype.md)