Skip to main content

IXtfUserClient::ListUsers

返回当前与此主机关联的所有用户的列表。

语法

参数

ppUserData
类型:XTF_USER_DATA **
成功返回时,指向一个 XTF_USER_DATA 对象数组,描述当前与该主机关联的用户。 pCount
类型:UINT32 *
成功返回时,ppUserData 数组中的元素数量。

返回值

类型:HRESULT HRESULT 成功或错误代码。

备注

调用方代码负责使用 CoTaskMemFree 释放与 ppUserData 关联的内存。 如果用户是受赞助(来宾)用户,则 XTF_USER_DATA 对象中 szEmailAddress 的值为空字符串,而 szGamertag 派生自赞助用户的玩家代号。 如果用户从未在此主机上登录过,则 szGamertag 为空字符串。 若要向此主机添加用户,请使用 AddUser。若要添加来宾用户,请使用 AddSponsoredUser

要求

头文件: xtfuser.h 库: xtfuser.lib 支持的平台: Windows(用于 XBOX 主机工具)

另请参阅

IXtfUserClient 接口
最后修改于 2026年8月24日