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) |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de