> ## 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

Retourne la liste de tous les utilisateurs actuellement associés à cette console.

## Syntaxe

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

### Paramètres

*ppUserData*\
Type : XTF\_USER\_DATA \*\*

En cas de réussite, pointe vers un tableau d'objets [XTF\_USER\_DATA](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) décrivant les utilisateurs actuellement associés à la console.

*pCount*\
Type : UINT32 \*

En cas de réussite, le nombre d'éléments du tableau *ppUserData*.

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

## Remarques

Votre code appelant est responsable de libérer la mémoire associée à *ppUserData* à l'aide de `CoTaskMemFree`.

Si un utilisateur est un utilisateur parrainé (invité), la valeur de `szEmailAddress` dans l'objet [XTF\_USER\_DATA](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) est une chaîne vide, et `szGamertag` est dérivé du gamertag de l'utilisateur parrain.

Si un utilisateur ne s'est jamais connecté sur cette console, `szGamertag` est une chaîne vide.

Pour ajouter un utilisateur à cette console, utilisez [AddUser](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md). Pour ajouter un utilisateur invité, utilisez [AddSponsoredUser](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/addsponsoreduser-ixtfuserclient-xtfuser-xbox-windows-m.md).

## Configuration requise

**En-tête :** xtfuser.h

**Bibliothèque :** xtfuser.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

[Interface IXtfUserClient](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)


## Related topics

- [XTF_USER_DATA](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [PairControllerWithUser](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [PairControllerWithUserId](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Interface IXtfUserClient (contenu de l'interface)](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [ListUsersEx](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)