Skip to main content

XblSocialManagerUserGroupGetUsersTrackedByGroup

获取指向 XSAPI 拥有的、由该组跟踪的 xuid 数组的指针。

语法

参数

group   _In_
类型:XblSocialManagerUserGroupHandle
要从中获取用户的组。 trackedUsers   _Outptr_result_maybenull_
类型:uint64_t**
传回指向所跟踪 xuid 数组的指针。返回指针指向的内存在下一次调用 XblSocialManagerDoWork 之前一直有效。 trackedUsersCount   _Out_
类型:size_t*
传回所跟踪用户数组的大小。

返回值

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

备注

对于基于列表的组,所跟踪的用户集是静态的(即,创建该组时提供的 xuid 列表),但对于基于筛选器的组,所跟踪的用户集会随着本地用户的关系变化而变化。在调用 XblSocialManagerCreateSocialUserGroupFromFiltersXblSocialManagerCreateSocialUserGroupFromList 创建 XblSocialManagerUserGroup 之后调用此 API。使用 XblSocialManagerDoWork 中的 XblSocialManagerEventType::SocialUserGroupLoaded 事件返回的 XblSocialManagerUserGroupHandle。

要求

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

另请参阅

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