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

# XblMultiplayerEventArgsFindMatchCompleted

> XblMultiplayerEventArgsFindMatchCompleted

# XblMultiplayerEventArgsFindMatchCompleted

检索 `XblMultiplayerEventType.FindMatchCompleted` 多人游戏事件的其他信息。

## 语法

```cpp theme={null}
HRESULT XblMultiplayerEventArgsFindMatchCompleted(  
         XblMultiplayerEventArgsHandle argsHandle,  
         XblMultiplayerMatchStatus* matchStatus,  
         XblMultiplayerMeasurementFailure* initializationFailureCause  
)  
```

### 参数

*argsHandle*   \_In\_\
类型：[XblMultiplayerEventArgsHandle](/reference/live/xsapi-c/multiplayer_manager_c/handles/xblmultiplayereventargshandle)

多人游戏事件的事件参数句柄。

*matchStatus*   \_Out\_opt\_\
类型：[XblMultiplayerMatchStatus\*](/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayermatchstatus)

描述当前匹配状态的调用方分配的结构。

*initializationFailureCause*   \_Out\_opt\_\
类型：[XblMultiplayerMeasurementFailure\*](/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure)

调用方分配的结构，用于传回初始化失败的原因，如果没有失败则为 `XblMultiplayerMeasurementFailure::None`。此值在退出 `XblMultiplayerMatchStatus::Joining` 或 `XblMultiplayerMatchStatus::Measuring` 初始化阶段时设置，如果此成员未通过初始化阶段。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

调用此函数以获取有关 [xblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 返回的多人游戏事件的更多信息，这些事件的多人游戏事件的 [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) 的 `EventType` 成员设置为 `XblMultiplayerEventType.FindMatchCompleted`。<br />多人游戏事件的事件参数句柄可以从该多人游戏事件的 [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) 结构的 `EventArgsHandle` 成员中检索。<br />有关多人游戏事件的详细信息，请参阅[多人游戏管理器 API 概述](/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview)。

## 要求

**头文件：** 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)\
[XblMultiplayerEventArgsMember](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmember)\
[XblMultiplayerEventArgsMembers](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmembers)\
[XblMultiplayerEventArgsMembersCount](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmemberscount)\
[XblMultiplayerEventArgsPerformQosMeasurements](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsperformqosmeasurements)\
[XblMultiplayerEventArgsPropertiesJson](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargspropertiesjson)\
[XblMultiplayerEventArgsXuid](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsxuid)\
[XblMultiplayerEventType](/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype)


## Related topics

- [XblMultiplayerEventArgsMember](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmember.md)
- [XblMultiplayerEventArgsMembers](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmembers.md)
- [XblMultiplayerEventArgsXuid](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsxuid.md)
- [XblMultiplayerEventArgsMembersCount](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmemberscount.md)
- [XblMultiplayerEventArgsPropertiesJson](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargspropertiesjson.md)