XblSocialManagerCreateSocialUserGroupFromFilters
Constructs a XblSocialManagerUserGroup, which is a collection of users with social information.
Syntax
HRESULT XblSocialManagerCreateSocialUserGroupFromFilters(
XblUserHandle user,
XblPresenceFilter presenceFilter,
XblRelationshipFilter relationshipFilter,
XblSocialManagerUserGroupHandle* group
)
Parameters
user _In_
Type: XblUserHandle
Xbox Live User the group is associated with.
presenceFilter _In_
Type: XblPresenceFilter
The restriction of users based on their presence and title activity.
relationshipFilter _In_
Type: XblRelationshipFilter
The restriction of users based on their relationship to the calling user.
group _Outptr_result_maybenull_
Type: XblSocialManagerUserGroupHandle*
Passes back a handle to the created group. This group can be later be cleaned up with XblSocialManagerDestroySocialUserGroup. The group will also be cleaned up (invalidating the returned handle) if the associated user is removed from Social Manager.
Return value
Type: HRESULT
HRESULT return code for this API operation.
Remarks
The result of a user group being loaded will be triggered through the XblSocialManagerEventType::SocialUserGroupLoaded event in XblSocialManagerDoWork.
Requirements
Header: social_manager_c.h
Library: Microsoft.Xbox.Services.141.GSDK.C.lib