XblSocialManagerUserGroupGetUsersTrackedByGroup

获取指向该组跟踪的 XSAPI 拥有的 xuids 数组的指针。

语法

HRESULT XblSocialManagerUserGroupGetUsersTrackedByGroup(  
         XblSocialManagerUserGroupHandle group,  
         const uint64_t** trackedUsers,  
         size_t* trackedUsersCount  
)  

参数

group _In_
类型:XblSocialManagerUserGroupHandle

从中获取用户的组。

trackedUsers _Outptr_result_maybenull_
类型:uint64_t**

传回指向跟踪的 xuid 数组的指针。 所返回指针的内存一直保持有效,直到下一次调用 XblSocialManagerDoWork

trackedUsersCount _Out_
类型:size_t*

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

返回值

类型:HRESULT

此 API 操作的 HRESULT 返回代码。

备注

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

要求

头文件:social_manager_c.h

库:Microsoft.Xbox.Services.141.GSDK.C.lib

另请参阅

social_manager_c