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

# XblMultiplayerEventArgsFindMatchCompleted

> XblMultiplayerEventArgsFindMatchCompleted

# XblMultiplayerEventArgsFindMatchCompleted

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

## 语法

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

### 参数

*argsHandle*   \_In\_\
类型：[XblMultiplayerEventArgsHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/handles/xblmultiplayereventargshandle.md)

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

*matchStatus*   \_Out\_opt\_\
类型：[XblMultiplayerMatchStatus\*](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayermatchstatus.md)

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

*initializationFailureCause*   \_Out\_opt\_\
类型：[XblMultiplayerMeasurementFailure\*](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure.md)

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

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

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

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[multiplayer\_manager\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerEventArgsMember](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmember.md)\
[XblMultiplayerEventArgsMembers](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmembers.md)\
[XblMultiplayerEventArgsMembersCount](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmemberscount.md)\
[XblMultiplayerEventArgsPerformQosMeasurements](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsperformqosmeasurements.md)\
[XblMultiplayerEventArgsPropertiesJson](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargspropertiesjson.md)\
[XblMultiplayerEventArgsXuid](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsxuid.md)\
[XblMultiplayerEventType](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype.md)


## Related topics

- [XblMultiplayerEventArgsHandle](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/handles/xblmultiplayereventargshandle.md)
- [XblMultiplayerEventArgsXuid](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsxuid.md)
- [XblMultiplayerEventArgsMember](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmember.md)
- [XblMultiplayerEventArgsMembers](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmembers.md)
- [XblMultiplayerEventArgsMembersCount](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmemberscount.md)