> ## 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，它是包含社交信息的用户集合。

## 语法

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

### 参数

*user*   \_In\_\
类型：XblUserHandle

XBOX Live 用户。

*xboxUserIdList*   \_In\_\
类型：uint64\_t\*

用于填充 XBOX 社交用户组的用户列表。该列表不能超过 XBL\_SOCIAL\_MANAGER\_MAX\_USERS\_FROM\_LIST。

*xboxUserIdListCount*   \_In\_\
类型：size\_t

xboxUserIdList 中的项数。

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

传回所创建组的句柄。稍后可以使用 XblSocialManagerDestroySocialUserGroup 清理此组。如果从社交管理器中移除关联用户，也将清理该组（使返回的句柄失效）。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

加载用户组的结果将通过 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 中的 [XblSocialManagerEventType](/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype)::SocialUserGroupLoaded 事件触发。

## 要求

**标头：** social\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

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


## Related topics

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