IXtfUserClient::ListUsers
返回当前与此主机关联的所有用户的列表。语法
参数
ppUserData类型:XTF_USER_DATA ** 成功返回时,指向一个 XTF_USER_DATA 对象数组,描述当前与该主机关联的用户。 pCount
类型:UINT32 * 成功返回时,ppUserData 数组中的元素数量。
返回值
类型:HRESULT HRESULT 成功或错误代码。备注
调用方代码负责使用CoTaskMemFree 释放与 ppUserData 关联的内存。
如果用户是受赞助(来宾)用户,则 XTF_USER_DATA 对象中 szEmailAddress 的值为空字符串,而 szGamertag 派生自赞助用户的玩家代号。
如果用户从未在此主机上登录过,则 szGamertag 为空字符串。
若要向此主机添加用户,请使用 AddUser。若要添加来宾用户,请使用 AddSponsoredUser。
