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

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

<a id="syntaxSection" />

## Sintaxis

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

<a id="ID4EG" />

<a id="parametersSection" />

### Parámetros

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

Cuando se devuelve correctamente, apunta a una matriz de objetos [XTF\_USER\_DATA](/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) 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*.

<a id="ID4EP" />

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Código de éxito o de error HRESULT.

<a id="remarks" />

<a id="remarksSection" />

## 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](/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t) 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](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/adduser-ixtfuserclient-xtfuser-xbox-windows-m). Para agregar un usuario invitado, use [AddSponsoredUser](/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/addsponsoreduser-ixtfuserclient-xtfuser-xbox-windows-m).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtfuser.h

**Biblioteca:** xtfuser.lib

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

<a id="seealsoSection" />

## Consulte también

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


## Related topics

- [XTF_USER_DATA](/es/reference/tools/xtf/xtfuser/structures/XTF_USER_DATA-xtfuser-xbox-windows-t.md)
- [IXtfUserClient::ListUsersEx](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/ixtfuserclient_listusersex.md)
- [Método IXtfUserClient::PairControllerWithUser](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuser-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [Método IXtfUserClient::PairControllerWithUserId](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/paircontrollerwithuserid-ixtfuserclient-xtfuser-xbox-windows-m.md)
- [IXtfUserClient::SignoutUser](/es/reference/tools/xtf/xtfuser/classes/IXtfUserClient/methods/signoutuser-ixtfuserclient-xtfuser-xbox-windows-m.md)