> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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\*](https://docs.xbox.com/ko/reference/live/xsapi-c/social_manager_c/handles/xblsocialmanagerusergrouphandle.md)

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

### Return value

Type: HRESULT

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

## Remarks

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

## Requirements

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

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

## See also

[social\_manager\_c](https://docs.xbox.com/ko/reference/live/xsapi-c/social_manager_c/social_manager_c_members.md)


## Related topics

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