通过

XblPresenceGetPresenceForSocialGroupAsync

  • 项目

获取特定用户组的状态信息。

语法

HRESULT XblPresenceGetPresenceForSocialGroupAsync(  
         XblContextHandle xblContextHandle,  
         const char* socialGroupName,  
         uint64_t* socialGroupOwnerXuid,  
         XblPresenceQueryFilters* filters,  
         XAsyncBlock* async  
)

参数

xblContextHandle _In_
类型：XblContextHandle

本地用户的 Xbox Live 上下文。

socialGroupName _In_z_
类型：char*

这可以是“收藏夹”，用于检索有关收藏夹的信息，“好友”用于检索有关共同好友的信息，也可以是“人员”，用于检索有关共同好友和用户关注的人员的信息， (保留此选项是为了) 向后兼容。

socialGroupOwnerXuid _In_opt_
类型：uint64_t*

应将其组作为目标的用户。 如果输入为 null，则将使用当前用户。

filters _In_opt_
类型：XblPresenceQueryFilters*

用于筛选结果的可选的筛选器结构。

async _In_
类型：XAsyncBlock*

此操作的 AsyncBlock。

备注

若要检索调用 XblPresenceGetPresenceForSocialGroupAsync 的结果，请调用 XblPresenceGetPresenceForSocialGroupResult。

若要检索所需的缓冲区大小以保存调用 XblPresenceGetPresenceForSocialGroupAsync 的结果，请调用 XblPresenceGetPresenceForSocialGroupResultCount。

返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

要求

头文件：presence_c.h

图书馆： Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

presence_c