Skip to main content

​
XblPresenceGetPresenceForSocialGroupAsync

특정 사용자 그룹에 대한 현재 상태 정보를 가져옵니다.

​
Syntax

​
Parameters

xblContextHandle   _In_
Type: XblContextHandle 로컬 사용자의 XBOX live 컨텍스트입니다. socialGroupName   _In_z_
Type: char* 현재 상태를 가져올 사용자 그룹의 이름입니다. 즐겨찾기에 대한 정보를 검색하려면 “Favorites”, 상호 친구와 사용자가 팔로우하는 사람에 대한 정보를 검색하려면 “People”, 상호 친구에 대한 정보를 검색하려면 “Friends”를 사용할 수 있습니다. socialGroupOwnerXuid   _In_opt_
Type: uint64_t* 대상이 될 그룹의 소유자 사용자입니다. 입력이 null이면 현재 사용자가 사용됩니다. filters   _In_opt_
Type: XblPresenceQueryFilters* 결과를 필터링하기 위한 선택적 filters 구조체입니다. async   _In_
Type: XAsyncBlock* 이 작업에 대한 AsyncBlock입니다.

​
Return value

Type: HRESULT 이 API 작업의 HRESULT 반환 코드입니다.

​
Remarks

XblPresenceGetPresenceForSocialGroupAsync 호출 결과를 검색하려면 XblPresenceGetPresenceForSocialGroupResult를 호출합니다. XblPresenceGetPresenceForSocialGroupAsync 호출 결과를 담을 필요한 버퍼 크기를 검색하려면 XblPresenceGetPresenceForSocialGroupResultCount를 호출합니다.

​
Requirements

Header: presence_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

​
See also

presence_c
마지막 수정일 2026년 8월 24일

관련 항목

XblPresenceGetPresenceForSocialGroupResultXblPresenceGetPresenceForSocialGroupResultCountXblPresenceQueryFilters사용자의 Presence 가져오기XblPresenceGetPresenceAsync