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

# XblSocialManagerUserGroupGetUsers

> XblSocialManagerUserGroupGetUsers

# XblSocialManagerUserGroupGetUsers

获取用户组跟踪的用户的 XblSocialManagerUserPtrArray。

## 语法

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

### 参数

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

要从中获取用户的组句柄。

*users*   \_Outptr\_result\_maybenull\_\
类型：XblSocialManagerUserPtrArray\*

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

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

传回 users 数组的大小。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

XblSocialManagerUserPtrArray 仅保证在下一次调用 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 之前有效。如果在下一次 [XblSocialManagerDoWork](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerdowork) 调用范围之外仍需要用户对象，用户对象是静态大小且可轻松复制的。在调用 [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)


## Related topics

- [Social Manager 概述](/zh-CN/services/xbox-services/community/social-manager/live-social-manager-overview.md)
- [XblSocialManagerUserGroupGetUsersTrackedByGroup](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetuserstrackedbygroup.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)
- [XblSocialManagerUserGroupGetFilters](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetfilters.md)