Freigeben über


XblSocialManagerUserGroupGetUsersTrackedByGroup

Gets a pointer to an XSAPI owned array of xuids tracked by the group.

Syntax

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

Parameters

group   _In_
Type: XblSocialManagerUserGroupHandle

The group from which to get users.

trackedUsers   _Outptr_result_maybenull_
Type: uint64_t**

Passes back a pointer to tracked xuids array. The memory for the returned pointer remains valid until the next time XblSocialManagerDoWork is called.

trackedUsersCount   _Out_
Type: size_t*

Passes back the size of the tracked users array.

Return value

Type: HRESULT

HRESULT return code for this API operation.

Remarks

For list-based groups, the set of tracked users is static (i.e. the list of xuids provided when the group is created), but for filter-based groups, the set tracked users changes as the local user's relationships change. Call this API after calling either XblSocialManagerCreateSocialUserGroupFromFilters or XblSocialManagerCreateSocialUserGroupFromList to create an XblSocialManagerUserGroup. Have the XblSocialManagerUserGroupHandle returned by the XblSocialManagerEventType::SocialUserGroupLoaded event in XblSocialManagerDoWork.

Requirements

Header: social_manager_c.h

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

See also

social_manager_c