跳轉到主要內容

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年10月20日