Skip to main content

IXtfUserClient::ListUsers

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

Sintaxis

Parámetros

ppUserData
Tipo: XTF_USER_DATA **
Cuando se devuelve correctamente, apunta a una matriz de objetos XTF_USER_DATA 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 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. Para agregar un usuario invitado, use AddSponsoredUser.

Requisitos

Encabezado: xtfuser.h Biblioteca: xtfuser.lib Plataformas compatibles: Windows (para herramientas de consola XBOX)

Consulte también

Interfaz IXtfUserClient
Última modificación el 28 de agosto de 2026