> ## 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.

# XblSocialManagerCreateSocialUserGroupFromList

> XblSocialManagerCreateSocialUserGroupFromList

# XblSocialManagerCreateSocialUserGroupFromList

소셜 정보가 있는 사용자 컬렉션인 소셜 XblSocialManagerUserGroup을 생성합니다.

## Syntax

```cpp theme={null}
HRESULT XblSocialManagerCreateSocialUserGroupFromList(  
         XblUserHandle user,  
         uint64_t* xboxUserIdList,  
         size_t xboxUserIdListCount,  
         XblSocialManagerUserGroupHandle* group  
)  
```

### Parameters

*user*   \_In\_\
Type: XblUserHandle

XBOX Live 사용자입니다.

*xboxUserIdList*   \_In\_\
Type: uint64\_t\*

XBOX 소셜 사용자 그룹을 채울 사용자 목록입니다. 이 목록은 XBL\_SOCIAL\_MANAGER\_MAX\_USERS\_FROM\_LIST를 초과할 수 없습니다.

*xboxUserIdListCount*   \_In\_\
Type: size\_t

xboxUserIdList의 항목 수입니다.

*group*   \_Outptr\_result\_maybenull\_\
Type: [XblSocialManagerUserGroupHandle\*](/reference/live/xsapi-c/social_manager_c/handles/xblsocialmanagerusergrouphandle)

생성된 그룹에 대한 핸들을 반환합니다. 이 그룹은 나중에 XblSocialManagerDestroySocialUserGroup으로 정리할 수 있습니다. 연결된 사용자가 소셜 관리자에서 제거되면 이 그룹도 정리되며(반환된 핸들이 무효화됨) 함께 정리됩니다.

### Return value

Type: HRESULT

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

## Remarks

사용자 그룹이 로드된 결과는 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork)의 [XblSocialManagerEventType](/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype)::SocialUserGroupLoaded 이벤트를 통해 트리거됩니다.

## Requirements

**Header:** social\_manager\_c.h

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

## See also

[social\_manager\_c](/reference/live/xsapi-c/social_manager_c/social_manager_c_members)


## Related topics

- [XblSocialManagerDestroySocialUserGroup](/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdestroysocialusergroup.md)
- [XblSocialManagerUserGroupGetLocalUser](/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetlocaluser.md)
- [XblSocialManagerUserGroupGetType](/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgettype.md)
- [XblSocialManagerUpdateSocialUserGroup](/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerupdatesocialusergroup.md)
- [XblSocialManagerUserGroupGetFilters](/ko/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetfilters.md)