IXtfUserClient::ListUsers
傳回目前與此主機相關聯之所有使用者的清單。語法
參數
ppUserData類型:XTF_USER_DATA ** 成功傳回時,指向描述目前與主機相關聯之使用者的 XTF_USER_DATA 物件陣列。 pCount
類型:UINT32 * 成功傳回時,ppUserData 陣列中的元素計數。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
您的呼叫端程式碼負責使用CoTaskMemFree 釋放與 ppUserData 相關聯的記憶體。
如果使用者是受贊助的 (來賓) 使用者,XTF_USER_DATA 物件中的 szEmailAddress 值會是空字串,而 szGamertag 則衍生自贊助使用者的玩家代號。
如果使用者從未在此主機上登入,szGamertag 會是空字串。
若要將使用者新增至此主機,請使用 AddUser。若要新增來賓使用者,請使用 AddSponsoredUser。
