Compartilhar 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 .

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

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
Este 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, ele retorna o
nome da sessão dos 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 de estação de janela com suporte para uma estação de janela interativa é
"WinSta0", cada sessão é associada à 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.


















ValorSignificado

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 ocioso 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 de área de trabalho remota. Para obter mais informações, consulte WTSINFO.
WTSSessionInfoEx
Informações estendidas sobre uma sessão em um servidor host da 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.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Cabeçalho wtsapi32.h

Confira também

WTSQuerySessionInformation