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

# XblSocialManagerGetLocalUsers

> XblSocialManagerGetLocalUsers

# XblSocialManagerGetLocalUsers

返回 SocialManager 跟踪的所有用户的用户句柄。

## 语法

```cpp theme={null}
HRESULT XblSocialManagerGetLocalUsers(  
         size_t usersCount,  
         XblUserHandle* users  
)  
```

### 参数

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

用户句柄数组的大小。

*users*   \_Out\_writes\_(usersCount)\
类型：XblUserHandle\*

传回一个指向数组的指针，该数组将填充本地用户。此数组仅在下一次调用 XblSocialManagerDoWork 之前有效。返回的用户句柄不是重复的副本，因此不要对它们调用 close。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

在返回句柄之前不会调用 duplicate handle，因此，如果在将用户从 SocialManager 中移除后仍需要该用户，则必须调用 duplicate handle。请确保已通过调用 [XblSocialManagerAddLocalUser](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanageraddlocaluser) 为至少一个本地用户创建了社交图。此外，调用 [XblSocialManagerGetLocalUserCount](/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagergetlocalusercount) 以获取当前跟踪的本地用户数量。

## 要求

**标头：** 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

- [XblSocialManagerGetLocalUserCount](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagergetlocalusercount.md)
- [XblSocialManagerUserGroupGetLocalUser](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetlocaluser.md)
- [XblSocialManagerAddLocalUser](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanageraddlocaluser.md)
- [XblSocialManagerRemoveLocalUser](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerremovelocaluser.md)
- [XblSocialManagerUserGroupGetUsers](/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagerusergroupgetusers.md)