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

# ListUsers

> IXtfUserClient::ListUsers

# IXtfUserClient::ListUsers

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

## 構文

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

### パラメーター

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

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

*pCount*\
型: UINT32 \*

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

### 戻り値

型: HRESULT

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

## 解説

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

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

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

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

## 要件

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

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

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

## 関連項目

[IXtfUserClient インターフェイス](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)


## Related topics

- [XTF_USER_DATA](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [PairControllerWithUser](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [PairControllerWithUserId](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient インターフェイス (インターフェイスの目次)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [ListUsersEx](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)