Compartilhar via


estrutura WRDS_CONNECTION_SETTINGS_1 (wtsdefs.h)

Contém informações de configuração de conexão para uma sessão remota.

Sintaxe

typedef struct _WRDS_CONNECTION_SETTINGS_1 {
  BOOLEAN                    fInheritInitialProgram;
  BOOLEAN                    fInheritColorDepth;
  BOOLEAN                    fHideTitleBar;
  BOOLEAN                    fInheritAutoLogon;
  BOOLEAN                    fMaximizeShell;
  BOOLEAN                    fDisablePNP;
  BOOLEAN                    fPasswordIsScPin;
  BOOLEAN                    fPromptForPassword;
  BOOLEAN                    fDisableCpm;
  BOOLEAN                    fDisableCdm;
  BOOLEAN                    fDisableCcm;
  BOOLEAN                    fDisableLPT;
  BOOLEAN                    fDisableClip;
  BOOLEAN                    fResetBroken;
  BOOLEAN                    fDisableEncryption;
  BOOLEAN                    fDisableAutoReconnect;
  BOOLEAN                    fDisableCtrlAltDel;
  BOOLEAN                    fDoubleClickDetect;
  BOOLEAN                    fEnableWindowsKey;
  BOOLEAN                    fUsingSavedCreds;
  BOOLEAN                    fMouse;
  BOOLEAN                    fNoAudioPlayback;
  BOOLEAN                    fRemoteConsoleAudio;
  BYTE                       EncryptionLevel;
  USHORT                     ColorDepth;
  USHORT                     ProtocolType;
  USHORT                     HRes;
  USHORT                     VRes;
  USHORT                     ClientProductId;
  USHORT                     OutBufCountHost;
  USHORT                     OutBufCountClient;
  USHORT                     OutBufLength;
  ULONG                      KeyboardLayout;
  ULONG                      MaxConnectionTime;
  ULONG                      MaxDisconnectionTime;
  ULONG                      MaxIdleTime;
  ULONG                      PerformanceFlags;
  ULONG                      KeyboardType;
  ULONG                      KeyboardSubType;
  ULONG                      KeyboardFunctionKey;
  ULONG                      ActiveInputLocale;
  ULONG                      SerialNumber;
  ULONG                      ClientAddressFamily;
  ULONG                      ClientBuildNumber;
  ULONG                      ClientSessionId;
  WCHAR                      WorkDirectory[WTS_DIRECTORY_LENGTH + 1];
  WCHAR                      InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1];
  WCHAR                      UserName[WTS_USERNAME_LENGTH + 1];
  WCHAR                      Domain[WTS_DOMAIN_LENGTH + 1];
  WCHAR                      Password[WTS_PASSWORD_LENGTH + 1];
  WCHAR                      ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1];
  WCHAR                      DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1];
  WCHAR                      DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1];
  WCHAR                      imeFileName[WTS_IMEFILENAME_LENGTH + 1];
  WCHAR                      AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1];
  WCHAR                      ClientName[WTS_CLIENTNAME_LENGTH + 1];
  WCHAR                      ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1];
  WCHAR                      ClientDirectory[WTS_DIRECTORY_LENGTH + 1];
  WCHAR                      ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1];
  WRDS_SOCKADDR              ClientSockAddress;
  WRDS_TIME_ZONE_INFORMATION ClientTimeZone;
  WRDS_LISTENER_SETTINGS     WRdsListenerSettings;
  GUID                       EventLogActivityId;
#if ...
  ULONG                      ContextSize;
#if ...
  PBYTE                      ContextData;
#else
  ULONG                      ContextSize;
#endif
#else
  PBYTE                      ContextData;
#endif
} WRDS_CONNECTION_SETTINGS_1, *PWRDS_CONNECTION_SETTINGS_1;

Membros

fInheritInitialProgram

Especifica se o programa inicial a ser iniciado no shell dos Serviços de Área de Trabalho Remota é herdado. Esse valor substitui o valor do registro do ouvinte fInheritInitialProgram .

fInheritColorDepth

Especifica se a profundidade da cor do monitor deve ser herdada. Esse valor substitui o valor do registro do ouvinte fInheritColorDepth .

fHideTitleBar

Especifica se a barra de título está oculta.

fInheritAutoLogon

Especifica se o processo de logon é automático. Esse valor substitui o valor do registro do ouvinte fInheritAutoLogon .

fMaximizeShell

Especifica se o programa inicial é exibido maximizado. Esse valor será usado se fInheritInitialProgram estiver definido como TRUE.

fDisablePNP

Especifica se o redirecionamento PNP está habilitado. Esse valor é definido inicialmente a partir de informações de política. Se você redefinir o valor, a política será substituída.

fPasswordIsScPin

Especifica que um cartão inteligente foi usado durante o processo de logon. O PIN de cartão inteligente é a senha. Esse valor será usado se fInheritAutoLogon estiver definido como TRUE.

fPromptForPassword

Especifica se o usuário deve solicitar uma senha ao usuário. Se esse valor for TRUE, o usuário será solicitado mesmo se o valor do registro fInheritAutoLogon for TRUE e a política "Sempre solicitar uma senha" não estiver definida.

fDisableCpm

Especifica se o mapeamento de impressora está habilitado. Esse valor é definido inicialmente a partir de informações de política. Se você redefinir o valor, a política será substituída.

fDisableCdm

Especifica se o mapeamento de unidade está habilitado. Esse valor é definido inicialmente a partir de informações de política. Se você redefinir o valor, a política será substituída.

fDisableCcm

Especifica se o mapeamento de porta COM está habilitado. Esse valor é definido inicialmente a partir de informações de política. Se você redefinir o valor, a política será substituída.

fDisableLPT

Especifica se o redirecionamento de impressora LPT está habilitado. Esse valor é definido inicialmente a partir de informações de política. Se você redefinir o valor, a política será substituída.

fDisableClip

Especifica se o redirecionamento da área de transferência está habilitado. Esse valor é definido inicialmente a partir de informações de política. Se você redefinir o valor, a política será substituída.

fResetBroken

Especifica a ação que o servidor executa quando a conexão ou os temporizadores ociosos expiram ou quando uma conexão é perdida devido a um erro de conexão.

FALSE

A sessão está desconectada, mas permanece no servidor.

TRUE

A sessão foi encerrada.

fDisableEncryption

Especifica se a criptografia deve ser desabilitada para comunicação entre o cliente e o servidor.

fDisableAutoReconnect

Especifica se deve desabilitar a reconexão automática do cliente.

fDisableCtrlAltDel

Especifica se o atalho de teclado Ctrl+Alt+Delete está desabilitado.

fDoubleClickDetect

Especifica se o cliente pode clicar duas vezes.

fEnableWindowsKey

Especifica se a chave do Windows está habilitada.

fUsingSavedCreds

Especifica se o cliente está usando credenciais salvas durante o processo de logon.

fMouse

Especifica se a entrada do mouse está habilitada.

fNoAudioPlayback

Especifica se a reprodução de áudio deve ser ativada. Um valor true não especifica nenhum áudio.

fRemoteConsoleAudio

Especifica se é necessário deixar a reprodução de áudio no computador remoto.

EncryptionLevel

Especifica o nível de criptografia.

ColorDepth

Especifica a profundidade de cor do monitor do cliente. Para obter valores possíveis, consulte o membro ColorDepth da estrutura WTS_CLIENT_DISPLAY .

ProtocolType

Especifica o tipo de protocolo.

HRes

Especifica a resolução horizontal do monitor do cliente.

VRes

Especifica a resolução vertical do monitor do cliente.

ClientProductId

A ID do produto de software cliente.

OutBufCountHost

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

OutBufCountClient

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

OutBufLength

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

KeyboardLayout

Especifica o layout do teclado.

MaxConnectionTime

A duração máxima da sessão dos Serviços de Área de Trabalho Remota, em minutos.

MaxDisconnectionTime

A quantidade máxima de tempo, em minutos, que uma sessão desconectada dos Serviços de Área de Trabalho Remota permanece ativa no servidor host da sessão rd.

MaxIdleTime

A quantidade máxima de tempo, em minutos, que a sessão dos Serviços de Área de Trabalho Remota pode permanecer ociosa.

PerformanceFlags

Especifica um conjunto de recursos que podem ser definidos no servidor para melhorar o desempenho. Isso pode ser uma combinação de um ou mais dos valores a seguir.

WRDS_PERF_DISABLE_NOTHING (0x00000000)

Nenhum recurso está desabilitado.

WRDS_PERF_DISABLE_WALLPAPER (0x00000001)

O papel de parede na área de trabalho não é exibido.

WRDS_PERF_DISABLE_FULLWINDOWDRAG (0x00000002)

O arrastar de janela inteira está desabilitado; somente a estrutura de tópicos da janela é exibida quando a janela é movida.

WRDS_PERF_DISABLE_MENUANIMATIONS (0x00000004)

As animações de menu estão desabilitadas.

WRDS_PERF_DISABLE_THEMING (0x00000008)

Os temas estão desabilitados.

WRDS_PERF_ENABLE_ENHANCED_GRAPHICS (0x00000010)

Habilitar gráficos aprimorados.

WRDS_PERF_DISABLE_CURSOR_SHADOW (0x00000020)

Nenhuma sombra é exibida para o cursor.

WRDS_PERF_DISABLE_CURSORSETTINGS (0x00000040)

O cursor piscando está desabilitado.

WRDS_PERF_ENABLE_FONT_SMOOTHING (0x00000080)

Habilitar a suavização de fonte.

WRDS_PERF_ENABLE_DESKTOP_COMPOSITION (0x00000100)

Habilitar a composição da área de trabalho.

KeyboardType

Especifica o tipo de teclado.

KeyboardSubType

Especifica o subtipo de teclado.

KeyboardFunctionKey

Especifica a chave de função.

ActiveInputLocale

Especifica o identificador de localidade de entrada. A palavra baixa contém um identificador de idioma e a palavra alta contém um identificador de dispositivo para o layout físico do teclado.

SerialNumber

O número de série exclusivo do computador cliente.

ClientAddressFamily

A família de endereços IP do cliente.

ClientBuildNumber

O número de build do cliente.

ClientSessionId

A ID da sessão do cliente.

WorkDirectory[WTS_DIRECTORY_LENGTH + 1]

Uma cadeia de caracteres que contém o diretório em que o programa inicial reside. Esse valor será usado se fInheritInitialProgram estiver definido como TRUE.

InitialProgram[WTS_INITIALPROGRAM_LENGTH + 1]

Um valor de cadeia de caracteres que especifica o nome do programa inicial. Esse valor será usado se fInheritInitialProgram estiver definido como TRUE.

UserName[WTS_USERNAME_LENGTH + 1]

Uma cadeia de caracteres que especifica o nome de usuário. Esse valor será usado se fInheritAutoLogon estiver definido como TRUE.

Domain[WTS_DOMAIN_LENGTH + 1]

Uma cadeia de caracteres que especifica o domínio do usuário. Esse valor será usado se fInheritAutoLogon estiver definido como TRUE.

Password[WTS_PASSWORD_LENGTH + 1]

Uma cadeia de caracteres que especifica a senha do usuário. Esse valor será usado se fInheritAutoLogon estiver definido como TRUE.

ProtocolName[WTS_PROTOCOL_NAME_LENGTH + 1]

Uma cadeia de caracteres que contém o nome do protocolo.

DisplayDriverName[WTS_DRIVER_NAME_LENGTH + 1]

Uma cadeia de caracteres que especifica o nome do driver de exibição a ser carregado.

DisplayDeviceName[WTS_DEVICE_NAME_LENGTH + 1]

Uma cadeia de caracteres que especifica o nome do dispositivo de exibição.

imeFileName[WTS_IMEFILENAME_LENGTH + 1]

Especifica o nome do editor do método de entrada.

AudioDriverName[WTS_DRIVER_NAME_LENGTH + 1]

Uma cadeia de caracteres que contém o nome do driver de áudio a ser carregado.

ClientName[WTS_CLIENTNAME_LENGTH + 1]

Uma cadeia de caracteres que contém o nome totalmente qualificado do computador cliente.

ClientAddress[WTS_CLIENTADDRESS_LENGTH + 1]

Uma cadeia de caracteres que contém o endereço IP do cliente no formato decimal pontilhado.

ClientDirectory[WTS_DIRECTORY_LENGTH + 1]

O diretório do cliente.

Uma cadeia de caracteres que contém o diretório do cliente.

ClientDigProductId[WTS_CLIENT_PRODUCT_ID_LENGTH + 1]

Uma cadeia de caracteres que contém um identificador de produto cliente.

ClientSockAddress

Uma estrutura WRDS_SOCKADDR que contém informações de endereço do soquete.

ClientTimeZone

Uma estrutura WRDS_TIME_ZONE_INFORMATION que contém informações de fuso horário do cliente.

WRdsListenerSettings

Uma estrutura WRDS_LISTENER_SETTINGS que contém as configurações do ouvinte.

EventLogActivityId

ContextSize

O tamanho, em bytes, da matriz ContextData .

ContextData

Uma matriz de bytes que contém dados contextuais para a conexão. O tamanho dessa matriz é especificado no membro ContextSize .

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2012
Cabeçalho wtsdefs.h (include Wtsprotocol.h)