enumeración WTS_INFO_CLASS (wtsapi32.h)

Contiene valores que indican el tipo de información de sesión que se va a recuperar en una llamada a la función WTSQuerySessionInformation .

Syntax

typedef enum _WTS_INFO_CLASS {
  WTSInitialProgram,
  WTSApplicationName,
  WTSWorkingDirectory,
  WTSOEMId,
  WTSSessionId,
  WTSUserName,
  WTSWinStationName,
  WTSDomainName,
  WTSConnectState,
  WTSClientBuildNumber,
  WTSClientName,
  WTSClientDirectory,
  WTSClientProductId,
  WTSClientHardwareId,
  WTSClientAddress,
  WTSClientDisplay,
  WTSClientProtocolType,
  WTSIdleTime,
  WTSLogonTime,
  WTSIncomingBytes,
  WTSOutgoingBytes,
  WTSIncomingFrames,
  WTSOutgoingFrames,
  WTSClientInfo,
  WTSSessionInfo,
  WTSSessionInfoEx,
  WTSConfigInfo,
  WTSValidationInfo,
  WTSSessionAddressV4,
  WTSIsRemoteSession,
  WTSSessionActivityId,
  WTSCapabilityCheck
} WTS_INFO_CLASS;

Constants

WTSInitialProgram
Cadena terminada en NULL que contiene el nombre del programa inicial que se ejecuta Servicios de Escritorio remoto cuando el
el usuario inicia sesión.

WTSApplicationName
Cadena terminada en null que contiene el nombre publicado de la aplicación que se está ejecutando la sesión.

Windows Server 2008 R2, Windows 7, Windows Server 2008 y Windows Vista: Este valor no se admite

WTSWorkingDirectory
Cadena terminada en NULL que contiene el directorio predeterminado que se usa al iniciar el programa inicial.

WTSOEMId
Este valor no se usa.

WTSSessionId
Valor de ULONG que contiene el identificador de sesión.

WTSUserName
Cadena terminada en NULL que contiene el nombre del usuario asociado a la sesión.

WTSWinStationName
Cadena terminada en NULL que contiene el nombre de la sesión de Servicios de Escritorio remoto.

Nota A pesar de su nombre, especificar este tipo no devuelve el nombre de la estación de ventana. En su lugar, devuelve el
nombre de la sesión de Servicios de Escritorio remoto. Cada sesión de Servicios de Escritorio remoto está asociada a una ventana interactiva
estación. Dado que el único nombre de estación de ventana admitido para una estación de ventana interactiva es
"WinSta0", cada sesión está asociada a su propia estación de ventana "WinSta0". Para obtener más información, consulte
Estaciones de ventana.

WTSDomainName
Cadena terminada en NULL que contiene el nombre del dominio al que pertenece el usuario que ha iniciado sesión.

WTSConnectState
Estado de conexión actual de la sesión. Para obtener más información, consulte
WTS_CONNECTSTATE_CLASS.

WTSClientBuildNumber
Valor de ULONG que contiene el número de compilación del cliente.

WTSClientName
Cadena terminada en null que contiene el nombre del cliente.

WTSClientDirectory
Cadena terminada en null que contiene el directorio en el que está instalado el cliente.

WTSClientProductId
Un identificador de producto específico del cliente de USHORT .

WTSClientHardwareId
Valor de ULONG que contiene un identificador de hardware específico del cliente. Esta opción está reservada para uso futuro. WTSQuerySessionInformation siempre devolverá un valor de 0.

WTSClientAddress
Tipo de red y dirección de red del cliente. Para obtener más información, consulte
WTS_CLIENT_ADDRESS.

La dirección IP se desplaza por dos bytes desde el principio del miembro Address del WTS_CLIENT_ADDRESS
estructura.

WTSClientDisplay
Información sobre la resolución de visualización del cliente. Para obtener más información, consulte
WTS_CLIENT_DISPLAY.

WTSClientProtocolType
Valor de USHORT que especifica información sobre el tipo de protocolo para
sesión. Este es uno de los siguientes valores.

Importancia	Meaning
0	Sesión de consola.
1	Este valor se conserva con fines heredados.
2	Protocolo RDP.

WTSIdleTime
Este valor devuelve FALSE. Si llama a GetLastError para obtener información de error extendida, GetLastError devuelve ERROR_NOT_SUPPORTED.

Para calcular el tiempo de inactividad de la sesión, use el campo de estructura LastInputTime .

Windows Server 2008 y Windows Vista: Este valor no se usa.

WTSLogonTime
Este valor devuelve FALSE. Si llama a GetLastError para obtener información de error extendida, GetLastError devuelve ERROR_NOT_SUPPORTED.

Windows Server 2008 y Windows Vista: Este valor no se usa.

WTSIncomingBytes
Este valor devuelve FALSE. Si llama a GetLastError para obtener información de error extendida, GetLastError devuelve ERROR_NOT_SUPPORTED.

Windows Server 2008 y Windows Vista: Este valor no se usa.

WTSOutgoingBytes
Este valor devuelve FALSE. Si llama a GetLastError para obtener información de error extendida, GetLastError devuelve ERROR_NOT_SUPPORTED.

Windows Server 2008 y Windows Vista: Este valor no se usa.

WTSIncomingFrames
Este valor devuelve FALSE. Si llama a GetLastError para obtener información de error extendida, GetLastError devuelve ERROR_NOT_SUPPORTED.

Windows Server 2008 y Windows Vista: Este valor no se usa.

WTSOutgoingFrames
Este valor devuelve FALSE. Si llama a GetLastError para obtener información de error extendida, GetLastError devuelve ERROR_NOT_SUPPORTED.

Windows Server 2008 y Windows Vista: Este valor no se usa.

WTSClientInfo
Información sobre un cliente de Conexión a Escritorio remoto (RDC). Para obtener más información, consulte WTSCLIENT.

WTSSessionInfo
Información sobre una sesión de cliente en un servidor host de sesión de Escritorio remoto. Para obtener más información, vea WTSINFO.

WTSSessionInfoEx
Información extendida sobre una sesión en un servidor host de sesión de Escritorio remoto. Para obtener más información, vea WTSINFOEX.

Windows Server 2008 y Windows Vista: Este valor no se admite.

WTSConfigInfo
Estructura WTSCONFIGINFO que contiene información sobre la configuración de un servidor host de sesión de Escritorio remoto.

Windows Server 2008 y Windows Vista: Este valor no se admite.

WTSValidationInfo
Este valor no se admite.

WTSSessionAddressV4
Estructura WTS_SESSION_ADDRESS que contiene la dirección IPv4 asignada a la sesión.
Si la sesión no tiene una dirección IP virtual, la función WTSQuerySessionInformation devuelve ERROR_NOT_SUPPORTED.

Windows Server 2008 y Windows Vista: Este valor no se admite.

WTSIsRemoteSession
Determina si la sesión actual es una sesión remota. La función WTSQuerySessionInformation devuelve un valor true para indicar que la sesión actual es una sesión remota y FALSE para indicar que la sesión actual es una sesión local. Este valor solo se puede usar para la máquina local, por lo que el parámetro hServer de la función WTSessionInformation debe contener WTS_CURRENT_SERVER_HANDLE.

Windows Server 2008 y Windows Vista: Este valor no se admite.

WTSSessionActivityId
Valor GUID que contiene el identificador de actividad de Terminal Services asociado actualmente a la sesión.

Versiones anteriores a Windows Server 2025 o Windows 11 (23H2): Este valor no se admite.

WTSCapabilityCheck
Matriz de valores UINT32 correspondientes a si el host de sesión admite determinadas funcionalidades.

Si la lista incluye el valor 59083637 , significa que se admite el protocolo RAIL v2.

Versiones anteriores a Windows Server 2025 o Windows 11 (24H2): Este valor no se admite.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Windows Vista
Servidor mínimo admitido	Windows Server 2008
Header	wtsapi32.h

Consulte también

WTSQuerySessionInformation

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-09-03