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

# XblMultiplayerManagerFindMatch

> XblMultiplayerManagerFindMatch

# XblMultiplayerManagerFindMatch

서버에 매치메이킹 요청을 제출합니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerManagerFindMatch(  
         const char* hopperName,  
         const char* attributesJson,  
         uint32_t timeoutInSeconds  
)  
```

### Parameters

*hopperName*   \_In\_z\_\
Type: char\*

이 요청의 호퍼 이름입니다.

*attributesJson*   \_In\_opt\_z\_\
Type: char\*

선택 사항입니다. JSON 문자열로 지정된 이 요청의 매치 티켓 속성입니다.

*timeoutInSeconds*   \_In\_\
Type: uint32\_t

사용자가 매치에 참여할 때까지 기다리는 최대 시간(초)입니다.

### Return value

Type: HRESULT

이 API 작업에 대한 HRESULT 반환 코드입니다.

## Remarks

이 함수는 로비 세션의 매치메이킹 요청을 Multiplayer Manager(MPM)에 제출합니다. 이 함수를 사용하기 전에 먼저 타이틀의 서비스 구성에서 호퍼를 구성해야 합니다. 호퍼는 SmartMatch가 플레이어를 매치하는 데 사용하는 규칙을 정의합니다. 호퍼에 대한 자세한 내용은 [매치메이킹 개요](/services/xbox-services/multiplayer/matchmaking/live-matchmaking-overview)를 참조하세요. [XblMultiplayerManagerInitialize](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerinitialize)가 호출되지 않았기 때문에 로비 세션이 없거나, 이 함수를 호출하기 전에 로컬 사용자가 로비 세션에 추가되지 않은 경우 오류가 발생합니다. 매치메이킹이 이미 진행 중인 경우에도 오류가 발생합니다. <br />이 함수의 결과는 이벤트 형식이 `XblMultiplayerEventType::FindMatchCompleted`로 설정된 멀티플레이어 이벤트로 전달됩니다. [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork)를 호출하여 멀티플레이어 이벤트를 검색할 수 있습니다.

## 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)\
[XblMultiplayerManagerEstimatedMatchWaitTime](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime)


## Related topics

- [XblMultiplayerManagerCancelMatch](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagercancelmatch.md)
- [XblMultiplayerManagerEstimatedMatchWaitTime](/ko/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerestimatedmatchwaittime.md)
- [SmartMatch 및 MPM을 사용한 멀티플레이어 매치메이킹](/ko/services/xbox-services/multiplayer/mpm/how-to/live-play-multiplayer-with-matchmaking.md)
- [Multiplayer Manager API 개요](/ko/services/xbox-services/multiplayer/mpm/concepts/live-multiplayer-manager-api-overview.md)
- [XblMultiplayerEventType](/ko/reference/live/xsapi-c/multiplayer_manager_c/enums/xblmultiplayereventtype.md)