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

# XblSocialManagerUserGroupGetUsersTrackedByGroup

> XblSocialManagerUserGroupGetUsersTrackedByGroup

# XblSocialManagerUserGroupGetUsersTrackedByGroup

取得指向由 XSAPI 擁有、包含群組所追蹤之 XUID 的陣列指標。

## 語法

```cpp theme={null}
HRESULT XblSocialManagerUserGroupGetUsersTrackedByGroup(  
         XblSocialManagerUserGroupHandle group,  
         const uint64_t** trackedUsers,  
         size_t* trackedUsersCount  
)  
```

### 參數

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

要從中取得使用者的群組。

*trackedUsers*   \_Outptr\_result\_maybenull\_\
類型：uint64\_t\*\*

傳回指向所追蹤 XUID 陣列的指標。傳回之指標的記憶體會保持有效，直到下次呼叫 [XblSocialManagerDoWork](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 為止。

*trackedUsersCount*   \_Out\_\
類型：size\_t\*

傳回所追蹤使用者陣列的大小。

### 傳回值

類型：HRESULT

此 API 作業的 HRESULT 傳回碼。

## 備註

對於以清單為基礎的群組，所追蹤的使用者集合是靜態的 (亦即建立群組時所提供的 XUID 清單)，但對於以篩選條件為基礎的群組，所追蹤的使用者集合會隨著本機使用者的關係變更而改變。請在呼叫 [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

- [XblSocialManagerUserGroupGetUsers](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetusers.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)
- [XblSocialManagerUserGroupGetFilters](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetfilters.md)
- [XblSocialUserGroupType](/zh-TW/reference/live/xsapi-c/social_manager_c/enums/xblsocialusergrouptype.md)