XblMultiplayerGetSearchHandlesAsync
연결된 검색 핸들로 세션을 검색합니다.
구문
HRESULT XblMultiplayerGetSearchHandlesAsync(
XblContextHandle xblContext,
const char* scid,
const char* sessionTemplateName,
const char* orderByAttribute,
bool orderAscending,
const char* searchFilter,
const char* socialGroup,
XAsyncBlock* async
)
매개 변수
xblContext _In_
형식: XblContextHandle
로컬 사용자용 Xbox Live 컨텍스트입니다.
scid _In_z_
형식: char*
검색 핸들을 쿼리할 SCID(서비스 구성 ID). SCID는 대소문자를 구분하므로 파트너 센터에서 직접 붙여넣기하세요
sessionTemplateName _In_z_
형식: char*
검색 핸들을 쿼리할 템플릿의 이름입니다.
orderByAttribute _In_opt_z_
형식: char*
검색 핸들의 정렬 기준이 되는 특성을 지정합니다. 빈 문자열을 기본값으로 전달하여 '타임스탬프 asc' 순으로 정렬합니다.
orderAscending _In_
형식: bool
오름차순에는 true를, 내림차순에는 false를 전달합니다.
searchFilter _In_opt_z_
형식: char*
검색 핸들을 가져올 쿼리 문자열입니다.
socialGroup _In_opt_z_
형식: char*
검색 핸들을 가져올 소셜 그룹입니다.
async _In_
형식: XAsyncBlock*
이 작업에 대한 AsyncBlock입니다.
반환 값
형식: HRESULT
이 API 작업에 대한 HRESULT 반환 코드입니다.
설명
필터링 검색 핸들: 쿼리 구문은 AND 및 OR 논리 연산자와 함께 EQ, NE, GE, GT, LE, LT를 지원하는 연산자만 있는 구문과 같은 OData입니다. 예 1: 특정 XboxUserId의 검색 핸들을 필터링하려면 "MemberXuids/any(d:d eq '12345678')" 또는 "OwnerXuids/any(d:d eq '12345678')" 사용 예 2: 타이틀이 정의된 문자열 메타데이터의 검색 핸들을 필터링하려면 "Strings/stringMetadataType eq 'value'" 사용 예 3: 타이틀이 정의된 번호 메타데이터 및 태그 유형 값의 검색 핸들을 검색하려면 "Numbers/numberMetadataType eq 53 AND Tags/tagType eq 'value'" 사용 빈 필터 및 소셜 그룹: searchFilter 및 socialGroup은 선택 사항이므로 필요하지 않거나 사용하지 않는 경우 nullptr을 전달해야 합니다. 빈 문자열 "" 전달은 작동하지 않습니다.
요건
헤더: multiplayer_c.h
도서관: Microsoft.Xbox.Services.14x.GDK.C.lib