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

# XblSocialManagerUpdateSocialUserGroup

> XblSocialManagerUpdateSocialUserGroup

# XblSocialManagerUpdateSocialUserGroup

將指定的社交使用者群組更新為新的使用者群組。

## 語法

```cpp theme={null}
HRESULT XblSocialManagerUpdateSocialUserGroup(  
         XblSocialManagerUserGroupHandle group,  
         uint64_t* users,  
         size_t usersCount  
)  
```

### 參數

*group*   \_In\_\
類型：[XblSocialManagerUserGroupHandle](/zh-TW/reference/live/xsapi-c/social_manager_c/handles/xblsocialmanagerusergrouphandle)

要更新的 Xbox 社交使用者群組。

*users*   \_In\_\
類型：uint64\_t\*

要追蹤的新使用者清單。請注意，這會取代現有的追蹤使用者清單。此清單不能超過 XBL\_SOCIAL\_MANAGER\_MAX\_USERS\_FROM\_LIST。

*usersCount*   \_In\_\
類型：size\_t

使用者陣列中的項目數。

### 傳回值

類型：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)::SocialUserGroupUpdated 事件觸發。請在呼叫 [XblSocialManagerCreateSocialUserGroupFromFilters](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters) 或 [XblSocialManagerCreateSocialUserGroupFromList](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist) 建立 XblSocialManagerUserGroup 之後呼叫此 API。須持有 [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 事件所傳回的 XblSocialManagerUserGroupHandle。

## 需求

**標頭：** 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

- [社交管理員概觀](/zh-TW/services/xbox-services/community/social-manager/live-social-manager-overview.md)
- [XblSocialManagerEventType](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblsocialmanagereventtype.md)
- [XblSocialManagerDestroySocialUserGroup](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdestroysocialusergroup.md)
- [XblSocialManagerCreateSocialUserGroupFromFilters](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters.md)
- [XblSocialManagerCreateSocialUserGroupFromList](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist.md)