Skip to main content

​
XblSocialGetSocialRelationshipsAsync

호출자와 사회적으로 연결된 사용자 목록을 가져옵니다.

​
Syntax

​
Parameters

xboxLiveContext   _In_
Type: XblContextHandle XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다. xboxUserId   _In_
Type: uint64_t 소셜 관계를 가져올 XBOX 사용자 ID입니다. socialRelationshipFilter   _In_
Type: XblSocialRelationshipFilter 목록을 필터링하는 방법을 제어합니다. startIndex   _In_
Type: size_t 결과 목록의 시작 인덱스를 제어합니다. maxItems   _In_
Type: size_t 결과 목록이 포함할 수 있는 항목의 최대 수입니다. 모든 항목을 가져오려면 0을 전달합니다. async   _In_
Type: XAsyncBlock* 호출자가 할당한 XAsyncBlock입니다.

​
Return value

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

​
Remarks

결과를 얻으려면 XblSocialGetSocialRelationshipsResult를 호출합니다.

​
REST Call

V1 GET /users//people?view=&startIndex=&maxItems=

​
Requirements

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

​
See also

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

관련 항목

XblSocialGetSocialRelationshipsResultXblSocialRelationshipFilterXblSocialRelationshipResultGetTotalCountXblSocialRelationshipResultGetNextAsync소셜 관계 가져오기