Skip to main content

​
XblSocialManagerGetLocalUsers

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

​
语法

​
参数

usersCount   _In_
类型：size_t 用户句柄数组的大小。 users   _Out_writes_(usersCount)
类型：XblUserHandle* 传回一个指向数组的指针，该数组将填充本地用户。此数组仅在下一次调用 XblSocialManagerDoWork 之前有效。返回的用户句柄不是重复的副本，因此不要对它们调用 close。

​
返回值

类型：HRESULT 此 API 操作的 HRESULT 返回代码。

​
备注

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

​
要求

标头： social_manager_c.h 库： Microsoft.Xbox.Services.14x.GDK.C.lib

​
另请参阅

social_manager_c
最后修改于 2026年8月13日

相关主题

XblSocialManagerGetLocalUserCountXblSocialManagerUserGroupGetLocalUserXblSocialManagerAddLocalUserXblSocialManagerRemoveLocalUserXblSocialManagerUserGroupGetUsers