この本体に現在関連付けられているすべてのユーザーのリストを返します。
構文
public:
HRESULT ListUsers(
XTF_USER_DATA **ppUserData,
UINT32 *pCount
)
パラメーター
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 本体ツール用)