XblSocialManagerCreateSocialUserGroupFromFilters

构造一个 XblSocialManagerUserGroup,它是一组包含社交信息的用户。

语法

HRESULT XblSocialManagerCreateSocialUserGroupFromFilters(  
         XblUserHandle user,  
         XblPresenceFilter presenceFilter,  
         XblRelationshipFilter relationshipFilter,  
         XblSocialManagerUserGroupHandle* group  
)  

参数

user _In_
类型:XblUserHandle

与此组关联的 Xbox Live 用户。

presenceFilter _In_
类型:XblPresenceFilter

根据用户的状态和游戏活动限制用户。

relationshipFilter _In_
类型:XblRelationshipFilter

基于用户与调用用户的关系限制用户。

group _Outptr_result_maybenull_
类型:XblSocialManagerUserGroupHandle*

传回已创建组的句柄。 稍后可以使用 XblSocialManagerDestroySocialUserGroup 清除此组。 如果从社交管理器中删除了关联的用户,该组也将被清理(使返回的句柄无效)。

返回值

类型:HRESULT

此 API 操作的 HRESULT 返回代码。

备注

所加载的用户组的结果将通过 XblSocialManagerDoWork 中的 XblSocialManagerEventType::SocialUserGroupLoaded 事件触发。

要求

头文件:social_manager_c.h

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

另请参阅

social_manager_c