> ## 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-TW/reference/live/xsapi-c/multiplayer_manager_c/handles/xblmultiplayereventargshandle.md)

多人遊戲事件的事件引數控制代碼。

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

由呼叫端配置的結構，描述目前的配對狀態。

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

由呼叫端配置的結構，傳回初始化失敗的原因；如果沒有失敗，則傳回 `XblMultiplayerMeasurementFailure::None`。如果此成員未通過初始化階段，則會在從 `XblMultiplayerMatchStatus::Joining` 或 `XblMultiplayerMatchStatus::Measuring` 初始化階段轉換出來時設定此值。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

呼叫此函式，可取得 [xblMultiplayerManagerDoWork](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork.md) 所傳回之多人遊戲事件的詳細資訊，這些事件的 [XblMultiplayerEvent](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md) 之 `EventType` 成員設定為 `XblMultiplayerEventType.FindMatchCompleted`。\
多人遊戲事件的事件引數控制代碼，可以從該多人遊戲事件之 [XblMultiplayerEvent](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent.md) 結構的 `EventArgsHandle` 成員擷取。\
如需多人遊戲事件的詳細資訊，請參閱 [Multiplayer Manager API 概觀](https://docs.xbox.com/zh-TW/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-TW/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerEventArgsMember](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmember.md)\
[XblMultiplayerEventArgsMembers](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmembers.md)\
[XblMultiplayerEventArgsMembersCount](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmemberscount.md)\
[XblMultiplayerEventArgsPerformQosMeasurements](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsperformqosmeasurements.md)\
[XblMultiplayerEventArgsPropertiesJson](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargspropertiesjson.md)\
[XblMultiplayerEventArgsXuid](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsxuid.md)\
[XblMultiplayerEventType](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype.md)


## Related topics

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