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

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

<a id="syntaxSection" />

## Syntaxe

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

<a id="ID4EG" />

<a id="parametersSection" />

### Paramètres

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

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

*pCount*\
Type : UINT32 \*

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

<a id="ID4EP" />

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

<a id="remarks" />

<a id="remarksSection" />

## Remarques

Votre code appelant est chargé 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](/fr/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) 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](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m). Pour ajouter un utilisateur invité, utilisez [AddSponsoredUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/addsponsoreduser-ixtfuserclient-xtfuser-xbox-windows-m).

<a id="requirementsSection" />

## Configuration requise

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

**Bibliothèque :** xtfuser.lib

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

<a id="seealsoSection" />

## Voir aussi

[Interface IXtfUserClient](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t)


## Related topics

- [XTF_USER_DATA](/fr/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [IXtfUserClient::ListUsersEx](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)
- [Méthode IXtfUserClient::PairControllerWithUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Méthode IXtfUserClient::PairControllerWithUserId](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SigninUser](/fr/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signinuser-ixtfuserclient-xtfuser-xbox-windows-m.md)