Skip to main content

XblSocialManagerUserGroupGetUsers

Gets an XblSocialManagerUserPtrArray of the users tracked by the user group.

Syntax

Parameters

group   _In_
Type: XblSocialManagerUserGroupHandle
The group handle from which to get users. users   _Outptr_result_maybenull_
Type: XblSocialManagerUserPtrArray*
Passes back a pointer to an array of XblSocialManagerUser objects. The memory for the returned pointer remains valid until the next time XblSocialManagerDoWork is called. usersCount   _Out_
Type: size_t*
Passes back the size of the users array.

Return value

Type: HRESULT HRESULT return code for this API operation.

Remarks

The XblSocialManagerUserPtrArray is only guaranteed to be valid until the next call to XblSocialManagerDoWork. If the user objects are needed beyond the scope of the next XblSocialManagerDoWork call, they are statically sized and trivially copyable. 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.14x.GDK.C.lib

See also

social_manager_c
Last modified on August 4, 2026