estrutura WTS_SESSION_INFO_1A (wtsapi32.h)

  • Artigo

Contém informações estendidas sobre uma sessão de cliente em um servidor host de sessão de área de trabalho remota (Host de Sessão de Área de Trabalho Remota) ou servidor do Host de Virtualização de Área de Trabalho Remota (Host de Virtualização de Área de Trabalho Remota).

Sintaxe

typedef struct _WTS_SESSION_INFO_1A {
  DWORD                  ExecEnvId;
  WTS_CONNECTSTATE_CLASS State;
  DWORD                  SessionId;
  LPSTR                  pSessionName;
  LPSTR                  pHostName;
  LPSTR                  pUserName;
  LPSTR                  pDomainName;
  LPSTR                  pFarmName;
} WTS_SESSION_INFO_1A, *PWTS_SESSION_INFO_1A;

Membros

ExecEnvId

Um identificador que identifica exclusivamente a sessão na lista de sessões retornadas pela função WTSEnumerateSessionsEx . Para obter mais informações, consulte Comentários.

State

Um valor do tipo de enumeração WTS_CONNECTSTATE_CLASS que especifica o estado de conexão de uma sessão dos Serviços de Área de Trabalho Remota.

SessionId

Um identificador de sessão atribuído pelo servidor host da sessão rd, servidor host de virtualização de área de trabalho remota ou máquina virtual.

pSessionName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome desta sessão. Por exemplo, "serviços", "console" ou "RDP-Tcp#0".

pHostName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do computador no qual a sessão está sendo executada. Se a sessão estiver sendo executada diretamente em um servidor host de sessão rd ou servidor host de virtualização de área de trabalho remota, a cadeia de caracteres conterá NULL. Se a sessão estiver em execução em uma máquina virtual, a cadeia de caracteres conterá o nome da máquina virtual.

pUserName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do usuário que está conectado à sessão. Se nenhum usuário estiver conectado à sessão, a cadeia de caracteres conterá NULL.

pDomainName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome de domínio do usuário que está conectado à sessão. Se nenhum usuário estiver conectado à sessão, a cadeia de caracteres conterá NULL.

pFarmName

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do farm ao qual a máquina virtual está ingressada. Se a sessão não estiver em execução em uma máquina virtual ingressada em um farm, a cadeia de caracteres conterá NULL.

Comentários

A função WTSEnumerateSessionsEx retornará essa estrutura se você chamar a função e especificar um identificador para um servidor Host de Virtualização de Área de Trabalho Remota que você obteve chamando a função WTSOpenServerEx . Nesse caso, a função WTSEnumerateSessionsEx agrega todas as sessões em execução no próprio host, bem como sessões em execução em máquinas virtuais individuais. O parâmetro ExecEnvId identifica exclusivamente cada sessão na lista agregada. Esse identificador pode ser diferente do identificador de sessão real definido no servidor ou na máquina virtual que hospeda a sessão, que é especificada pelo membro SessionId .

A sessão representada por essa estrutura pode ser uma sessão em execução diretamente no servidor ou em uma sessão em execução em uma máquina virtual. Se a sessão estiver em execução em uma máquina virtual, o membro pHostName conterá o nome da máquina virtual. O membro pFarmName é aplicável a sessões hospedadas em máquinas virtuais ingressadas em um farm de Host de Sessão de Área de Trabalho Remota.

Observação

O cabeçalho wtsapi32.h define WTS_SESSION_INFO_1 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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

Confira também

WTSEnumerateSessionsEx

WTS_SESSION_INFO