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