IXtfUserClient::ListUsers
このコンソールに現在関連付けられているすべてのユーザーの一覧を返します。構文
パラメーター
ppUserData型: XTF_USER_DATA ** 正常に返された場合、コンソールに現在関連付けられているユーザーを記述する XTF_USER_DATA オブジェクトの配列を指します。 pCount
型: UINT32 * 正常に返された場合、ppUserData 配列内の要素数。
戻り値
型: HRESULT HRESULT の成功またはエラー コード。解説
呼び出し元コードは、CoTaskMemFree を使用して ppUserData に関連付けられたメモリを解放する責任があります。
ユーザーがスポンサー付き (ゲスト) ユーザーである場合、XTF_USER_DATA オブジェクトの szEmailAddress の値は空の文字列となり、szGamertag はスポンサー ユーザーのゲーマータグから派生します。
ユーザーがこのコンソールで一度もサインインしていない場合、szGamertag は空の文字列になります。
このコンソールにユーザーを追加するには、AddUser を使用します。ゲスト ユーザーを追加するには、AddSponsoredUser を使用します。