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

Retrieves additional information for `XblMultiplayerEventType.FindMatchCompleted` multiplayer events.

## Syntax

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

### Parameters

*argsHandle*   \_In\_\
Type: [XblMultiplayerEventArgsHandle](/reference/live/xsapi-c/multiplayer_manager_c/handles/xblmultiplayereventargshandle)

The event arguments handle for the multiplayer event.

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

A caller-allocated structure that describes the current matchmaking status.

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

A caller-allocated structure that passes back the cause of why the initialization failed, or `XblMultiplayerMeasurementFailure::None` if there was no failure. This value is set when transitioning out of the `XblMultiplayerMatchStatus::Joining` or `XblMultiplayerMatchStatus::Measuring` initialization stages, if this member doesn't pass the initializaton stage.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

Call this function to get more information about multiplayer events returned by [xblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) for which the `EventType` member of the [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) for a multiplayer event is set to `XblMultiplayerEventType.FindMatchCompleted`. <br />The event arguments handle for a multiplayer event can be retrieved from the `EventArgsHandle` member of the [XblMultiplayerEvent](/reference/live/xsapi-c/multiplayer_manager_c/structs/xblmultiplayerevent) structure for that multiplayer event.  <br />For more information about multiplayer events, see [Multiplayer Manager API overview](/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview).

## Requirements

**Header:** multiplayer\_manager\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

[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

- [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)
- [XblMultiplayerEventArgsMembersCount](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargsmemberscount.md)
- [XblMultiplayerEventArgsPropertiesJson](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayereventargspropertiesjson.md)