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

Devuelve una lista de todos los usuarios asociados actualmente a esta consola.

## Sintaxis

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

### Parámetros

*ppUserData*\
Tipo: XTF\_USER\_DATA \*\*

Cuando se devuelve correctamente, apunta a una matriz de objetos [XTF\_USER\_DATA](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) que describen los usuarios asociados actualmente a la consola.

*pCount*\
Tipo: UINT32 \*

Cuando se devuelve correctamente, el número de elementos de la matriz *ppUserData*.

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

## Comentarios

El código de llamada es responsable de liberar la memoria asociada a *ppUserData* mediante `CoTaskMemFree`.

Si un usuario es un usuario patrocinado (invitado), el valor de `szEmailAddress` en el objeto [XTF\_USER\_DATA](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md) es una cadena vacía, y `szGamertag` se deriva del gamertag del usuario patrocinador.

Si un usuario nunca ha iniciado sesión en esta consola, `szGamertag` es una cadena vacía.

Para agregar un usuario a esta consola, use [AddUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m.md). Para agregar un usuario invitado, use [AddSponsoredUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/addsponsoreduser-ixtfuserclient-xtfuser-xbox-windows-m.md).

## Requisitos

**Encabezado:** xtfuser.h

**Biblioteca:** xtfuser.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

## Consulte también

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


## Related topics

- [XTF_USER_DATA](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [PairControllerWithUser](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [PairControllerWithUserId](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Interfaz IXtfUserClient (contenido de la interfaz)](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/ixtfuserclient-xtfuser-xbox-windows-t.md)
- [ListUsersEx](https://docs.xbox.com/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)