enumeración WTS_INFO_CLASS (wtsapi32.h)

  • Artículo

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
} WTS_INFO_CLASS;

Constantes

 
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 utiliza.
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
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 la estación de ventana compatible para una estación de ventana interactiva es
"WinSta0", cada sesión está asociada a su propia estación de ventanas "WinSta0". Para obtener más información, vea
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, vea
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, vea
WTS_CLIENT_ADDRESS.

La dirección IP se desplaza por dos bytes desde el inicio 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, vea
WTS_CLIENT_DISPLAY.
WTSClientProtocolType
Valor de USHORT que especifica información sobre el tipo de protocolo para el
Sesión. Se trata de uno de los siguientes valores.


















ValorSignificado

0


La 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 de 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 el equipo local, por lo que el parámetro hServer de la función WTSQuerySessionInformation debe contener WTS_CURRENT_SERVER_HANDLE.

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

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Encabezado wtsapi32.h

Consulte también

WTSQuerySessionInformation