> ## 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\*

此要求的 hopper 名稱。

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

選用。此要求之配對票證的屬性，以 JSON 字串表示。

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

等候使用者加入配對的最長時間 (以秒為單位)。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

此函式會將大廳工作階段的配對要求提交至 Multiplayer Manager (MPM)。您必須先在遊戲的服務設定中設定 hopper，才能使用此函式。hopper 會定義 SmartMatch 用來配對玩家的規則。如需 hopper 的詳細資訊，請參閱[配對概觀](/zh-TW/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview)。如果大廳工作階段不存在 (可能是因為未呼叫 [XblMultiplayerManagerInitialize](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize))，或在呼叫此函式之前未將本機使用者新增至大廳工作階段，就會發生錯誤。如果配對已在進行中，也會發生錯誤。<br />此函式的結果會以事件類型設定為 `XblMultiplayerEventType::FindMatchCompleted` 的多人遊戲事件傳遞。您可以呼叫 [XblMultiplayerManagerDoWork](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 來擷取多人遊戲事件。

## 需求

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




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

## 另請參閱

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


## Related topics

- [XblMultiplayerManagerFindMatch](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerfindmatch.md)
- [XblMultiplayerManagerCancelMatch](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)