Skip to main content

XblPresenceGetPresenceForMultipleUsersAsync

获取多个用户的在线状态信息。

语法

参数

xblContextHandle   _In_
类型:XblContextHandle
本地用户的 XBOX Live 上下文。 xuids   _In_
类型:uint64_t*
要获取在线状态的用户的 XBOX 用户 ID。 xuidsCount   _In_
类型:size_t
xuids 数组的大小。 filters   _In_opt_
类型:XblPresenceQueryFilters*
用于筛选结果的可选筛选器结构。 async   _In_
类型:XAsyncBlock*
此操作的 AsyncBlock。

返回值

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

备注

若要检索调用 XblPresenceGetPresenceForMultipleUsersAsync 的结果,请调用 XblPresenceGetPresenceForMultipleUsersResult 若要检索保存调用 XblPresenceGetPresenceForMultipleUsersAsync 的结果所需的缓冲区大小,请调用 XblPresenceGetPresenceForMultipleUsersResultCount

要求

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

另请参阅

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