Skip to main content

XblMultiplayerGetSearchHandlesAsync

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

Syntax

Parameters

xblContext   _In_
Type: 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
마지막 수정일 2026년 8월 24일