Skip to main content

XblProfileGetUserProfilesAsync

获取一组指定 XBOX 用户的一个或多个用户配置文件。

语法

参数

xboxLiveContext   _In_
类型:XblContextHandle
使用 XblContextCreateHandle 创建的 XBOX Live 上下文句柄。 xboxUserIds   _In_
类型:uint64_t*
要获取其配置文件的用户的 XBOX 用户 ID 的 C 样式数组。 xboxUserIdsCount   _In_
类型:size_t
数组中 XBOX 用户 ID 的数量。 async   _In_
类型:XAsyncBlock*
调用方分配的 AsyncBlock。

返回值

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

备注

若要获取结果,请先调用 XblProfileGetUserProfilesResultCount 以获取返回的配置文件数量,然后在 AsyncBlock 回调内或在 AsyncBlock 完成后调用 XblProfileGetUserProfilesResult

REST 调用

调用 V2 GET /users/batch/profile/settings

要求

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

另请参阅

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