> ## 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](/zh-TW/reference/live/xsapi-c/multiplayer_manager_c/handles/xblmultiplayereventargshandle)

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

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

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

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

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

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

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


## Related topics

- [XblMultiplayerEventArgsFindMatchCompleted](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsfindmatchcompleted.md)
- [XblMultiplayerEventArgsXuid](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsxuid.md)
- [XblMultiplayerEventArgsMember](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmember.md)
- [XblMultiplayerEventArgsMembers](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmembers.md)