> ## 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\*](/zh-TW/reference/live/xsapi-c/social_manager_c/handles/xblsocialmanagerusergrouphandle)

傳回所建立群組的控制代碼。此群組稍後可以使用 XblSocialManagerDestroySocialUserGroup 加以清除。如果相關聯的使用者從 Social Manager 中移除，群組也會被清除 (使傳回的控制代碼失效)。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

使用者群組載入的結果會透過 [XblSocialManagerDoWork](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 中的 [XblSocialManagerEventType](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype)::SocialUserGroupLoaded 事件觸發。

## 需求

**標頭：** social\_manager\_c.h

**程式庫：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另請參閱

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


## Related topics

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