> ## 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 返回代码。

## 备注

此函数将大厅会话的匹配请求提交到多人游戏管理器 (MPM)。在使用此函数之前，必须首先在游戏的服务配置中配置 hopper。hopper 定义 SmartMatch 用于匹配玩家的规则。有关 hopper 的详细信息，请参阅[匹配概述](/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](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [使用 SmartMatch 和 MPM 进行多人游戏匹配](/zh-CN/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Multiplayer Manager API 概述](/zh-CN/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblMultiplayerEventType](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype.md)