> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblProfileGetUserProfilesForSocialGroupAsync

> XblProfileGetUserProfilesForSocialGroupAsync

# XblProfileGetUserProfilesForSocialGroupAsync

지정된 소셜 그룹에 속한 사용자들의 프로필을 가져옵니다.

## Syntax

```cpp theme={null}
HRESULT XblProfileGetUserProfilesForSocialGroupAsync(  
         XblContextHandle xboxLiveContext,  
         const char* socialGroup,  
         XAsyncBlock* async  
)  
```

### Parameters

*xboxLiveContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XblContextCreateHandle로 생성된 XBOX live 컨텍스트 핸들입니다.

*socialGroup*   \_In\_z\_\
Type: char\*

검색할 사용자 소셜 그룹의 UTF-8로 인코딩된 이름입니다. 옵션은 "Favorites"와 "People"입니다.

*async*   \_In\_\
Type: XAsyncBlock\*

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

### Return value

Type: HRESULT

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

## Remarks

결과를 얻으려면 먼저 [XblProfileGetUserProfilesForSocialGroupResultCount](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresultcount)를 호출하여 반환된 프로필 개수를 가져온 다음, AsyncBlock 콜백 내부에서 또는 AsyncBlock이 완료된 후에 [XblProfileGetUserProfilesForSocialGroupResult](/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult)를 호출합니다.

## REST Call

V2 GET /users/{userId}/profile/settings/people/{socialGroup}을 호출합니다

## Requirements

**Header:** profile\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## See also

[profile\_c](/reference/live/xsapi-c/profile_c/profile_c_members)


## Related topics

- [XblProfileGetUserProfilesForSocialGroupResult](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresult.md)
- [XblProfileGetUserProfilesForSocialGroupResultCount](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesforsocialgroupresultcount.md)
- [XblProfileGetUserProfileAsync](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileasync.md)
- [XblProfileGetUserProfilesAsync](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofilesasync.md)
- [XblProfileGetUserProfileResult](/ko/reference/live/xsapi-c/profile_c/functions/xblprofilegetuserprofileresult.md)