XblPresenceGetPresenceForSocialGroupAsync
특정 사용자 그룹에 대한 프레즌스 정보를 가져옵니다.
구문
HRESULT XblPresenceGetPresenceForSocialGroupAsync(
XblContextHandle xblContextHandle,
const char* socialGroupName,
uint64_t* socialGroupOwnerXuid,
XblPresenceQueryFilters* filters,
XAsyncBlock* async
)
매개 변수
xblContextHandle _In_
형식: XblContextHandle
로컬 사용자용 Xbox Live 컨텍스트입니다.
socialGroupName _In_z_
형식: char*
즐겨찾기에 대한 정보를 검색하는 "즐겨찾기", 상호 친구에 대한 정보를 검색하는 "친구", 사용자가 팔로우하는 상호 친구 및 사용자에 대한 정보를 검색하는 "사람"일 수 있습니다(이 옵션은 이전 버전과의 호환성을 위해 유지됨).
socialGroupOwnerXuid _In_opt_
형식: uint64_t*
해당 그룹의 대상으로 지정할 사용자입니다. 입력이 null이면 현재 사용자가 사용됩니다.
filters _In_opt_
형식: XblPresenceQueryFilters*
결과를 필터링하기 위한 선택적인 필터 구조입니다.
async _In_
형식: XAsyncBlock*
이 작업에 대한 AsyncBlock입니다.
설명
XbXblPresenceGetPresenceForSocialGroupAsync 호출 결과를 검색하려면 XblPresenceGetPresenceForSocialGroupResult를 호출합니다.
XblPresenceGetPresenceForSocialGroupAsync 호출 결과를 저장하는 데 필요한 버퍼 크기를 검색하려면 XblPresenceGetPresenceForSocialGroupResultCount를 호출합니다.
반환 값
형식: HRESULT
이 API 작업에 대한 HRESULT 반환 코드입니다.
요구 사항
헤더: presence_c.h
도서관: Microsoft.Xbox.Services.14x.GDK.C.lib