> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfUserClient::ListUsers

> IXtfUserClient::ListUsers

# IXtfUserClient::ListUsers

このコンソールに現在関連付けられているすべてのユーザーの一覧を返します。

<a id="syntaxSection" />

## 構文

```cpp theme={null}
public:
HRESULT ListUsers(
         XTF_USER_DATA **ppUserData,
         UINT32 *pCount
)  
```

<a id="ID4EG" />

<a id="parametersSection" />

### パラメーター

*ppUserData*\
型: XTF\_USER\_DATA \*\*

正常に返された場合、コンソールに現在関連付けられているユーザーを記述する [XTF\_USER\_DATA](/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) オブジェクトの配列を指します。

*pCount*\
型: UINT32 \*

正常に返された場合、*ppUserData* 配列内の要素数。

<a id="ID4EP" />

<a id="retvalSection" />

### 戻り値

型: HRESULT

HRESULT の成功またはエラー コード。

<a id="remarks" />

<a id="remarksSection" />

## 解説

呼び出し元コードは、`CoTaskMemFree` を使用して *ppUserData* に関連付けられたメモリを解放する責任があります。

ユーザーがスポンサー付き (ゲスト) ユーザーである場合、[XTF\_USER\_DATA](/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) オブジェクトの `szEmailAddress` の値は空の文字列となり、`szGamertag` はスポンサー ユーザーのゲーマータグから派生します。

ユーザーがこのコンソールで一度もサインインしていない場合、`szGamertag` は空の文字列になります。

このコンソールにユーザーを追加するには、[AddUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m) を使用します。ゲスト ユーザーを追加するには、[AddSponsoredUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/addsponsoreduser-ixtfuserclient-xtfuser-xbox-windows-m) を使用します。

<a id="requirementsSection" />

## 要件

**ヘッダー:** xtfuser.h

**ライブラリ:** xtfuser.lib

**対応プラットフォーム:** Windows (XBOX コンソール ツール用)

<a id="seealsoSection" />

## 関連項目

[IXtfUserClient インターフェイス](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t)


## Related topics

- [XTF_USER_DATA](/ja-jp/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [IXtfUserClient::ListUsersEx](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)
- [IXtfUserClient::PairControllerWithUser メソッド](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::PairControllerWithUserId メソッド](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUser](/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md)