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

要从中获取用户的组。

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

传回指向所跟踪 xuid 数组的指针。返回指针指向的内存在下一次调用 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 之前一直有效。

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

传回所跟踪用户数组的大小。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

对于基于列表的组，所跟踪的用户集是静态的（即，创建该组时提供的 xuid 列表），但对于基于筛选器的组，所跟踪的用户集会随着本地用户的关系变化而变化。在调用 [XblSocialManagerCreateSocialUserGroupFromFilters](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromfilters) 或 [XblSocialManagerCreateSocialUserGroupFromList](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagercreatesocialusergroupfromlist) 创建 XblSocialManagerUserGroup 之后调用此 API。使用 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 中的 [XblSocialManagerEventType](/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](/reference/live/xsapi-c/social_manager_c/social_manager_c_members)