Skip to main content

XblPresenceGetPresenceForSocialGroupAsync

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

语法

参数

xblContextHandle   _In_
类型:XblContextHandle
本地用户的 XBOX live 上下文。 socialGroupName   _In_z_
类型:char*
要获取其状态的用户组名称。可以是 “Favorites”(用于检索收藏夹信息)、“People”(用于检索共同好友以及用户关注对象的信息)或 “Friends”(用于检索共同好友的信息)。 socialGroupOwnerXuid   _In_opt_
类型:uint64_t*
要针对其组进行操作的用户。如果输入为 null,则使用当前用户。 filters   _In_opt_
类型:XblPresenceQueryFilters*
用于筛选结果的可选筛选器结构。 async   _In_
类型:XAsyncBlock*
此操作的 AsyncBlock。

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

若要检索调用 XblPresenceGetPresenceForSocialGroupAsync 的结果,请调用 XblPresenceGetPresenceForSocialGroupResult。若要检索用于存放调用 XblPresenceGetPresenceForSocialGroupAsync 的结果所需的缓冲区大小,请调用 XblPresenceGetPresenceForSocialGroupResultCount

要求

头文件: presence_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

presence_c
最后修改于 2026年8月24日