Compartir a través de

Función WTSEnumerateSessionsA (wtsapi32.h)

  • Artículo

Recupera una lista de sesiones en un servidor host de sesión de Escritorio remoto (host de sesión de Escritorio remoto).

Sintaxis

BOOL WTSEnumerateSessionsA(
  [in]  HANDLE             hServer,
  [in]  DWORD              Reserved,
  [in]  DWORD              Version,
  [out] PWTS_SESSION_INFOA *ppSessionInfo,
  [out] DWORD              *pCount
);

Parámetros

[in] hServer

Identificador del servidor host de sesión de Escritorio remoto.

Nota Puede usar el WTSOpenServer de o funciones WTSOpenServerEx para recuperar un identificador de un servidor específico o WTS_CURRENT_SERVER_HANDLE para usar el servidor host de sesión de Escritorio remoto que hospeda la aplicación.
 

[in] Reserved

Este parámetro está reservado. Debe ser cero.

[in] Version

Versión de la solicitud de enumeración. Este parámetro debe ser 1.

[out] ppSessionInfo

Puntero a una matriz de WTS_SESSION_INFO estructuras que representan las sesiones recuperadas. Para liberar el búfer devuelto, llame a la función WTSFreeMemory.

permisos de sesión de :

  • Para enumerar una sesión, debe habilitar el permiso de información de consulta. Para obtener más información, consulte permisos de Servicios de Escritorio remoto.
  • Para cambiar los permisos en una sesión, use la herramienta administrativa Configuración de Servicios de Escritorio remoto.
  • Para enumerar las sesiones que se ejecutan en una máquina virtual hospedada en un servidor host de virtualización de Escritorio remoto, debe ser miembro del grupo Administradores en el servidor host de virtualización de Escritorio remoto.

[out] pCount

Puntero al número de estructuras de WTS_SESSION_INFO devueltas en el parámetro ppSessionInfo.

Valor devuelto

Devuelve cero si se produce un error en esta función. Si esta función se ejecuta correctamente, se devuelve un valor distinto de cero.

Para obtener información de error extendida, llame a GetLastError.

Observaciones

Nota

El encabezado wtsapi32.h define WTSEnumerateSessions como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista
servidor mínimo admitido Windows Server 2008
de la plataforma de destino de Windows
encabezado de wtsapi32.h
biblioteca de Wtsapi32.lib
DLL de Wtsapi32.dll
conjunto de API de ext-ms-win-session-wtsapi32-l1-1-0 (introducido en Windows 8)

Consulte también

WTS_SESSION_INFO