Estrutura WTSCLIENTA (wtsapi32.h)

Contém informações sobre um cliente RDC (Conexão de Área de Trabalho Remota).

Sintaxe

typedef struct _WTSCLIENTA {
  CHAR   ClientName[CLIENTNAME_LENGTH + 1];
  CHAR   Domain[DOMAIN_LENGTH + 1];
  CHAR   UserName[USERNAME_LENGTH + 1];
  CHAR   WorkDirectory[MAX_PATH + 1];
  CHAR   InitialProgram[MAX_PATH + 1];
  BYTE   EncryptionLevel;
  ULONG  ClientAddressFamily;
  USHORT ClientAddress[CLIENTADDRESS_LENGTH + 1];
  USHORT HRes;
  USHORT VRes;
  USHORT ColorDepth;
  CHAR   ClientDirectory[MAX_PATH + 1];
  ULONG  ClientBuildNumber;
  ULONG  ClientHardwareId;
  USHORT ClientProductId;
  USHORT OutBufCountHost;
  USHORT OutBufCountClient;
  USHORT OutBufLength;
  CHAR   DeviceId[MAX_PATH + 1];
} WTSCLIENTA, *PWTSCLIENTA;

Membros

ClientName[CLIENTNAME_LENGTH + 1]

O nome NetBIOS do computador cliente.

Domain[DOMAIN_LENGTH + 1]

O nome de domínio do computador cliente.

UserName[USERNAME_LENGTH + 1]

O nome de usuário do cliente.

WorkDirectory[MAX_PATH + 1]

A pasta do programa inicial.

InitialProgram[MAX_PATH + 1]

O programa a ser iniciado na conexão.

EncryptionLevel

O nível de segurança da criptografia.

ClientAddressFamily

A família de endereços. Esse membro pode ser AF_INET, AF_INET6, AF_IPX, AF_NETBIOSou AF_UNSPEC.

ClientAddress[CLIENTADDRESS_LENGTH + 1]

O endereço de rede do cliente.

HRes

Dimensão horizontal, em pixels, da exibição do cliente.

VRes

Dimensão vertical, em pixels, da exibição do cliente.

ColorDepth

Profundidade de cor da exibição do cliente. Para obter valores possíveis, consulte o membro ColorDepth da estrutura WTS_CLIENT_DISPLAY.

ClientDirectory[MAX_PATH + 1]

O local da DLL de controle ActiveX do cliente.

ClientBuildNumber

O número de build do cliente.

ClientHardwareId

Reservado.

ClientProductId

Reservado.

OutBufCountHost

O número de buffers de saída no servidor por sessão.

OutBufCountClient

O número de buffers de saída no cliente.

OutBufLength

O comprimento dos buffers de saída, em bytes.

DeviceId[MAX_PATH + 1]

A ID do dispositivo do adaptador de rede.

Observações

Para o membro ClientAddressFamily, AF_INET (IPv4) retornará no formato de cadeia de caracteres, por exemplo, "127.0.0.1". AF_INET6 (IPv6) retornará em formato binário.

Nota

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista com SP1
servidor com suporte mínimo	Windows Server 2008
cabeçalho	wtsapi32.h