다음을 통해 공유


XblSocialGetSocialRelationshipsAsync

호출자가 소셜로 연결된 사용자 목록을 가져옵니다.

구문

HRESULT XblSocialGetSocialRelationshipsAsync(  
         XblContextHandle xboxLiveContext,  
         uint64_t xboxUserId,  
         XblSocialRelationshipFilter socialRelationshipFilter,  
         size_t startIndex,  
         size_t maxItems,  
         XAsyncBlock* async  
)  

매개 변수

xboxLiveContext _In_
형식: XblContextHandle

XblContextCreateHandle로 생성된 Xbox Live 컨텍스트 핸들입니다.

xboxUserId _In_
형식: uint64_t

소셜 관계를 가져올 Xbox 사용자 ID입니다.

socialRelationshipFilter _In_
형식: XblSocialRelationshipFilter

목록이 필터링되는 방법을 제어합니다.

startIndex _In_
형식: size_t

결과 목록의 시작 인덱스를 제어합니다.

maxItems _In_
형식: size_t

결과 목록에 포함될 수 있는 항목의 최대 개수입니다. 모든 항목을 검색하려면 0을 전달합니다.

async _In_
형식: XAsyncBlock*

호출자가 할당한 XAsyncBlock입니다.

반환 값

형식: HRESULT

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

설명

XblSocialGetSocialRelationshipsResult를 호출하여 결과를 가져옵니다.

REST 호출

V1 GET /users/{ownerId}/people?view={view}&startIndex={startIndex}&maxItems={maxItems}

요구 사항

헤더: social_c.h

도서관: Microsoft.Xbox.Services.14x.GDK.C.lib

참고 항목

social_c