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 列表),但对于基于筛选器的组,跟踪的用户集随着本地用户的关系改变而改变。 在调用 XblSocialManagerCreateSocialUserGroupFromFilters 或 XblSocialManagerCreateSocialUserGroupFromList 来创建 XblSocialManagerUserGroup 后,调用此 API。 使 XblSocialManagerDoWork 中的 XblSocialManagerEventType::SocialUserGroupLoaded 事件返回 XblSocialManagerUserGroupHandle。
要求
头文件:social_manager_c.h
库:Microsoft.Xbox.Services.141.GSDK.C.lib