Partilhar via

WTS_INFO_CLASS enumeração (wtsapi32.h)

Contém valores que indicam o tipo de informações de sessão a serem recuperadas em uma chamada para a função WTSQuerySessionInformation .

Sintaxe

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
Uma cadeia de caracteres terminada em nulo que contém o nome do programa inicial executado pelos Serviços de Área de Trabalho Remota quando o
o usuário faz logon.
WTSApplicationName
Uma cadeia de caracteres terminada em nulo que contém o nome publicado do aplicativo em que a sessão está em execução.

Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista: Não há suporte para esse valor
WTSWorkingDirectory
Uma cadeia de caracteres terminada em nulo que contém o diretório padrão usado ao iniciar o programa inicial.
WTSOEMId
Esse valor não é usado.
WTSSessionId
Um valor ULONG que contém o identificador de sessão.
WTSUserName
Uma cadeia de caracteres terminada em nulo que contém o nome do usuário associado à sessão.
WTSWinStationName
Uma cadeia de caracteres terminada em nulo que contém o nome da sessão dos Serviços de Área de Trabalho Remota.

Nota Apesar do nome, especificar esse tipo não retorna o nome da estação de janela. Em vez disso, retorna o
nome da sessão de Serviços de Área de Trabalho Remota. Cada sessão dos Serviços de Área de Trabalho Remota está associada a uma janela interativa
estação. Como o único nome da estação de janela com suporte para uma estação de janela interativa é
"WinSta0", cada sessão é associada à sua própria estação de janela "WinSta0". Para obter mais informações, consulte
Estações de janela.

 
WTSDomainName
Uma cadeia de caracteres terminada em nulo que contém o nome do domínio ao qual o usuário conectado pertence.
WTSConnectState
O estado de conexão atual da sessão. Para obter mais informações, consulte
WTS_CONNECTSTATE_CLASS.
WTSClientBuildNumber
Um valor ULONG que contém o número de build do cliente.
WTSClientName
Uma cadeia de caracteres terminada em nulo que contém o nome do cliente.
WTSClientDirectory
Uma cadeia de caracteres terminada em nulo que contém o diretório no qual o cliente está instalado.
WTSClientProductId
Um identificador de produto específico do cliente USHORT .
WTSClientHardwareId
Um valor ULONG que contém um identificador de hardware específico do cliente. Essa opção é reservada para uso futuro. WTSQuerySessionInformation sempre retornará um valor de 0.
WTSClientAddress
O tipo de rede e o endereço de rede do cliente. Para obter mais informações, consulte
WTS_CLIENT_ADDRESS.

O endereço IP é deslocado por dois bytes desde o início do membro address do WTS_CLIENT_ADDRESS
estrutura.
WTSClientDisplay
Informações sobre a resolução de exibição do cliente. Para obter mais informações, consulte
WTS_CLIENT_DISPLAY.
WTSClientProtocolType
Um valor USHORT que especifica informações sobre o tipo de protocolo para o
sessão. Esse é um dos valores a seguir.


















ValueMeaning

0


A sessão do console.


1


Esse valor é retido para fins herdados.


2


O protocolo RDP.
WTSIdleTime
Esse valor retorna FALSE. Se você chamar GetLastError para obter informações de erro estendidas, GetLastError retornará ERROR_NOT_SUPPORTED.

Para cacular o tempo de ociosidade da sessão, use o campo de estrutura LastInputTime .

Windows Server 2008 e Windows Vista: Esse valor não é usado.
WTSLogonTime
Esse valor retorna FALSE. Se você chamar GetLastError para obter informações de erro estendidas, GetLastError retornará ERROR_NOT_SUPPORTED.

Windows Server 2008 e Windows Vista: Esse valor não é usado.
WTSIncomingBytes
Esse valor retorna FALSE. Se você chamar GetLastError para obter informações de erro estendidas, GetLastError retornará ERROR_NOT_SUPPORTED.

Windows Server 2008 e Windows Vista: Esse valor não é usado.
WTSOutgoingBytes
Esse valor retorna FALSE. Se você chamar GetLastError para obter informações de erro estendidas, GetLastError retornará ERROR_NOT_SUPPORTED.

Windows Server 2008 e Windows Vista: Esse valor não é usado.
WTSIncomingFrames
Esse valor retorna FALSE. Se você chamar GetLastError para obter informações de erro estendidas, GetLastError retornará ERROR_NOT_SUPPORTED.

Windows Server 2008 e Windows Vista: Esse valor não é usado.
WTSOutgoingFrames
Esse valor retorna FALSE. Se você chamar GetLastError para obter informações de erro estendidas, GetLastError retornará ERROR_NOT_SUPPORTED.

Windows Server 2008 e Windows Vista: Esse valor não é usado.
WTSClientInfo
Informações sobre um cliente RDC (Conexão de Área de Trabalho Remota). Para obter mais informações, consulte WTSCLIENT.
WTSSessionInfo
Informações sobre uma sessão de cliente em um servidor host de sessão rd. Para obter mais informações, consulte WTSINFO.
WTSSessionInfoEx
Informações estendidas sobre uma sessão em um servidor host de sessão rd. Para obter mais informações, consulte WTSINFOEX.

Windows Server 2008 e Windows Vista: Não há suporte para esse valor.
WTSConfigInfo
Uma estrutura WTSCONFIGINFO que contém informações sobre a configuração de um servidor host de sessão rd.

Windows Server 2008 e Windows Vista: Não há suporte para esse valor.
WTSValidationInfo
Não há suporte para esse valor.
WTSSessionAddressV4
Uma estrutura WTS_SESSION_ADDRESS que contém o endereço IPv4 atribuído à sessão.
Se a sessão não tiver um endereço IP virtual, a função WTSQuerySessionInformation retornará ERROR_NOT_SUPPORTED.

Windows Server 2008 e Windows Vista: Não há suporte para esse valor.
WTSIsRemoteSession
Determina se a sessão atual é uma sessão remota. A função WTSQuerySessionInformation retorna um valor TRUE para indicar que a sessão atual é uma sessão remota e FALSE para indicar que a sessão atual é uma sessão local. Esse valor só pode ser usado para o computador local, portanto, o parâmetro hServer da função WTSQuerySessionInformation deve conter WTS_CURRENT_SERVER_HANDLE.

Windows Server 2008 e Windows Vista: Não há suporte para esse valor.
WTSSessionActivityId
Um valor GUID que contém a ID de atividade dos Serviços de Terminal atualmente associada à sessão.

Versões anteriores ao Windows Server 2025 ou Windows 11 (23H2): Não há suporte para esse valor.
WTSCapabilityCheck
Uma matriz de valores UINT32 correspondentes a se determinados recursos são compatíveis com o host de sessão.

Se a lista incluir o valor 59083637 , isso significa que há suporte para o protocolo RAIL v2.

Versões anteriores ao Windows Server 2025 ou Windows 11 (24H2): Não há suporte para esse valor.

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista
Servidor mínimo compatível Windows Server 2008
Header wtsapi32.h

Consulte também

WTSQuerySessionInformation

  • Last updated on