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

# XblMultiplayerGetSearchHandlesAsync

> XblMultiplayerGetSearchHandlesAsync

# XblMultiplayerGetSearchHandlesAsync

세션에 연결된 검색 핸들을 이용해 세션을 검색합니다.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerGetSearchHandlesAsync(  
         XblContextHandle xblContext,  
         const char* scid,  
         const char* sessionTemplateName,  
         const char* orderByAttribute,  
         bool orderAscending,  
         const char* searchFilter,  
         const char* socialGroup,  
         XAsyncBlock* async  
)  
```

### Parameters

*xblContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

로컬 사용자의 XBOX live 컨텍스트입니다.

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

검색 핸들을 쿼리할 서비스 구성 ID(SCID)입니다. SCID는 대/소문자를 구분하므로 파트너 센터에서 직접 붙여넣으세요.

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

검색 핸들을 쿼리할 템플릿의 이름입니다.

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

검색 핸들을 정렬할 속성을 지정합니다. 기본적으로 'Timestamp asc'로 정렬하려면 빈 문자열을 전달하세요.

*orderAscending*   \_In\_\
Type: bool

오름차순으로 정렬하려면 true를, 내림차순으로 정렬하려면 false를 전달합니다.

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

검색 핸들을 가져올 쿼리 문자열입니다.

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

검색 핸들을 가져올 소셜 그룹입니다.

*async*   \_In\_\
Type: XAsyncBlock\*

이 작업에 대한 AsyncBlock입니다.

### Return value

Type: HRESULT

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

## Remarks

**검색 핸들 필터링:** 쿼리 구문은 OData와 유사한 구문이며, EQ, NE, GE, GT, LE, LT 연산자와 논리 연산자 AND, OR만 지원됩니다. 예제 1: 특정 XboxUserId에 대한 검색 핸들을 필터링하려면 "MemberXuids/any(d:d eq '12345678')" 또는 "OwnerXuids/any(d:d eq '12345678')"를 사용하세요. 예제 2: 타이틀에서 정의한 문자열 메타데이터에 대한 검색 핸들을 필터링하려면 "Strings/stringMetadataType eq 'value'"를 사용하세요. 예제 3: 타이틀에서 정의한 숫자 메타데이터 AND 태그 유형 값에 대한 검색 핸들을 필터링하려면 "Numbers/numberMetadataType eq 53 AND Tags/tagType eq 'value'"를 사용하세요. **빈 필터 및 소셜 그룹:** searchFilter와 socialGroup은 선택 사항이므로, 필요/사용하지 않는 경우 반드시 nullptr을 전달하세요. 빈 문자열 ""을 전달하면 **작동하지 않습니다**.

## Requirements

**Header:** multiplayer\_c.h

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

## See also

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerGetSearchHandlesResult](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresult.md)
- [XblMultiplayerGetSearchHandlesResultCount](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsearchhandlesresultcount.md)
- [MPSD에서 PlayFab Multiplayer 및 MPA로 이동](/ko/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [XblMultiplayerCreateSearchHandleAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayercreatesearchhandleasync.md)
- [XblMultiplayerDeleteSearchHandleAsync](/ko/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerdeletesearchhandleasync.md)