Interface IMsRdpClientAdvancedSettings
Gerencia as configurações avançadas do cliente. Deriva da interface IMsTscAdvancedSettings . Essa interface inclui métodos para recuperar e definir propriedades avançadas (opcionais) para o controle ActiveX da Área de Trabalho Remota.
Para obter uma instância dessa interface, use a propriedade IMsTscAx::AdvancedSettings para obter um ponteiro de interface IMsTscAdvancedSettings . Em seguida, chame QueryInterface no ponteiro IMsTscAdvancedSettings e passe IID_IMsRdpClientAdvancedSettings para QueryInterface.
Membros
A interface IMsRdpClientAdvancedSettings herda de IMsTscAdvancedSettings. IMsRdpClientAdvancedSettings também tem estes tipos de membros:
Propriedades
A interface IMsRdpClientAdvancedSettings tem essas propriedades.
| Propriedade | Tipo de acesso | Descrição |
|---|---|---|
| AcceleratorPassthrough |
Leitura/gravação |
Especifica se os aceleradores de teclado devem ser passados para o servidor. |
| BitmapCacheSize |
Leitura/gravação |
O tamanho, em quilobytes, do arquivo de cache de bitmap usado para bitmaps de 8 bits por pixel. Os valores numéricos válidos dessa propriedade são de 1 a 32, inclusive. |
| BitmapPersistence |
Leitura/gravação |
Especifica se o cache de bitmap persistente deve ser usado. O cache persistente pode melhorar o desempenho, mas requer espaço em disco adicional. |
| BitmapVirtualCache16BppSize |
Leitura/gravação |
Especifica o tamanho, em megabytes, do arquivo de cache de bitmap persistente a ser usado para as configurações de cores altas de 15 e 16 bits por pixel. |
| BitmapVirtualCache24BppSize |
Leitura/gravação |
Especifica o tamanho, em megabytes, do arquivo de cache de bitmap persistente a ser usado para a configuração de cor alta de 24 bits por pixel. |
| BitmapVirtualCacheSize |
Leitura/gravação |
Especifica o tamanho, em megabytes, do arquivo de cache de bitmap persistente a ser usado para a cor de 8 bits por pixel. Os valores numéricos válidos dessa propriedade são de 1 a 32, inclusive. Observe que o tamanho máximo para todos os arquivos de cache virtual é de 128 MB. As propriedades relacionadas incluem as propriedades BitmapVirtualCache16BppSize e BitmapVirtualCache24BppSize . |
| brushSupportLevel |
Leitura/gravação |
Não há suporte a esta propriedade. |
| CachePersistenceActive |
Leitura/gravação |
Especifica se o cache de bitmap persistente deve ser usado. |
| ClearTextPassword |
Somente gravação |
Especifica a senha com a qual se conectar. Para obter mais informações, consulte a interface IMsTscNonScriptable . |
| ConnectToServerConsole |
Leitura/gravação |
Não há suporte a esta propriedade. |
| ConnectWithEndpoint |
Somente gravação |
Não há suporte a esta propriedade. |
| DedicatedTerminal |
Leitura/gravação |
Não há suporte a esta propriedade. |
| DisableCtrlAltDel |
Leitura/gravação |
Especifica se a tela explicativa inicial no Winlogon deve ser exibida. |
| DisplayConnectionBar |
Leitura/gravação |
Especifica se a barra de conexão deve ser usada. O valor padrão é VARIANT_TRUE, que habilita a propriedade . |
| DoubleClickDetect |
Leitura/gravação |
Especifica se o cliente identifica cliques duplos para o servidor. |
| EnableMouse |
Leitura/gravação |
Não há suporte a esta propriedade. |
| EnableWindowsKey |
Leitura/gravação |
Especifica se a chave do Windows pode ser usada na sessão remota. |
| EncryptionEnabled |
Leitura/gravação |
Não há suporte a esta propriedade. A criptografia não pode ser desabilitada. |
| GrabFocusOnConnect |
Leitura/gravação |
Especifica se o controle do cliente deve ter o foco durante a conexão. |
| HotKeyAltEsc |
Leitura/gravação |
Especifica o código de chave virtual a ser adicionado ao ALT para determinar a substituição da tecla de acesso para ALT+ESC. VK_INSERT é o valor padrão, com ALT+INSERT como a sequência resultante. Essa propriedade é válida somente quando a propriedade KeyboardHookMode não está habilitada. |
| HotKeyAltShiftTab |
Leitura/gravação |
Especifica o código de chave virtual a ser adicionado ao ALT para determinar a substituição da tecla de atalho para ALT+SHIFT+TAB. VK_NEXT é o valor padrão, com ALT+PAGE DOWN como a sequência resultante. Essa propriedade é válida somente quando a propriedade KeyboardHookMode não está habilitada. |
| HotKeyAltSpace |
Leitura/gravação |
Especifica o código de chave virtual a ser adicionado ao ALT para determinar a substituição da tecla de atalho para ALT+SPACE. VK_DELETE é o padrão, com ALT+DELETE como a sequência resultante. Essa propriedade é válida somente quando a propriedade KeyboardHookMode não está habilitada. |
| HotKeyAltTab |
Leitura/gravação |
Especifica o código de chave virtual a ser adicionado ao ALT para determinar a substituição de tecla de acesso para ALT+TAB. VK_PRIOR é o valor padrão, com ALT+PAGE UP como a sequência resultante. Essa propriedade é válida somente quando a propriedade KeyboardHookMode não está habilitada. |
| HotKeyCtrlAltDel |
Leitura/gravação |
Especifica o código de chave virtual a ser adicionado a CTRL+ALT para determinar a substituição de tecla de acesso para CTRL+ALT+DELETE, também chamada de SAS (sequência de atenção segura). VK_END é o padrão. Observe que, mesmo quando a propriedade KeyboardHookMode está habilitada, CTRL+ALT+DELETE nunca é redirecionada para o servidor remoto; CTRL+ALT+DELETE é a sequência SAS local. |
| HotKeyCtrlEsc |
Leitura/gravação |
Especifica o código de chave virtual a ser adicionado ao ALT para determinar a substituição de tecla de acesso para CTRL+ESC. VK_HOME é o valor padrão, com ALT+HOME como a sequência resultante. Essa propriedade é válida somente quando a propriedade KeyboardHookMode não está habilitada. |
| HotKeyFullScreen |
Leitura/gravação |
Especifica o código de chave virtual a ser adicionado a CTRL+ALT para determinar a substituição de tecla de acesso para alternar para o modo de tela inteira. VK_CANCEL é o valor padrão. |
| InputEventsAtOnce |
Leitura/gravação |
Não há suporte a esta propriedade. |
| keepAliveInterval |
Leitura/gravação |
Especifica um intervalo, em milissegundos, no qual o cliente envia mensagens keep alive para o servidor. O valor padrão da propriedade é zero, o que desabilita mensagens keep alive. O valor mínimo válido dessa propriedade é 10.000, que representa 10 segundos. Observe que uma configuração de política de grupo que especifica se conexões de cliente persistentes com o servidor são permitidas pode substituir essa configuração de propriedade. |
| KeyboardFunctionKey |
Leitura/gravação |
Válido apenas para Windows CE. |
| KeyboardSubType |
Leitura/gravação |
Válido apenas para Windows CE. |
| KeyboardType |
Leitura/gravação |
Válido apenas para Windows CE. |
| LoadBalanceInfo |
Leitura/gravação |
Especifica o cookie de balanceamento de carga que será colocado no pacote solicitação de conexão X.224 na sequência de conexão de protocolo do servidor host da sessão rd. |
| maxEventCount |
Leitura/gravação |
Não há suporte a esta propriedade. |
| MaximizeShell |
Leitura/gravação |
Especifica se os programas iniciados com a propriedade StartProgram devem ser maximizados. |
| minInputSendInterval |
Leitura/gravação |
Especifica o intervalo mínimo, em milissegundos, entre o envio de eventos do mouse. |
| MinutesToIdleTimeout |
Leitura/gravação |
Especifica o período máximo de tempo, em minutos, que o cliente deve permanecer conectado sem a entrada do usuário. Se o tempo especificado decorrido, o controle chamará o método IMsTscAxEvents::OnIdleTimeoutNotification . |
| NotifyTSPublicKey |
Leitura/gravação |
Não há suporte a esta propriedade. |
| NumBitmapCaches |
Leitura/gravação |
Não há suporte a esta propriedade. |
| orderDrawThreshold |
Leitura/gravação |
Não há suporte a esta propriedade. |
| overallConnectionTimeout |
Leitura/gravação |
Especifica o período total de tempo, em segundos, que o controle do cliente aguarda a conclusão de uma conexão. O valor máximo válido dessa propriedade é 600, que representa 10 minutos. Se o tempo especificado decorrido antes da conclusão da conexão, o controle desconectará e chamará o método IMsTscAxEvents::OnDisconnected . Uma propriedade relacionada é singleConnectionTimeout. |
| PerformanceFlags |
Leitura/gravação |
Especifica um conjunto de recursos que podem ser definidos no servidor para melhorar o desempenho. |
| PersistCacheDirectory |
Somente gravação |
Não há suporte a esta propriedade. |
| PinConnectionBar |
Leitura/gravação |
Especifica o estado da barra de conexão da interface do usuário. Definir essa propriedade como VARIANT_TRUE define o estado como "reduzido", ou seja, invisível para o usuário e indisponível para entrada. VARIANT_FALSE define o estado como "gerado" e disponível para entrada do usuário. |
| RdpdrClipCleanTempDirString |
Leitura/gravação |
Não há suporte a esta propriedade. |
| RdpdrClipPasteInfoString |
Leitura/gravação |
Não há suporte a esta propriedade. |
| RdpdrLocalPrintingDocName |
Leitura/gravação |
Não há suporte a esta propriedade. |
| RDPPort |
Leitura/gravação |
Especifica a porta de conexão. O valor padrão é 3389. |
| RedirectDrives |
Leitura/gravação |
Especifica se o redirecionamento de unidades de disco é permitido. |
| RedirectPorts |
Leitura/gravação |
Especifica se o redirecionamento de portas locais (por exemplo, COM e LPT) é permitido. |
| RedirecionarImpressores |
Leitura/gravação |
Especifica se o redirecionamento de impressoras é permitido. |
| RedirectSmartCards |
Leitura/gravação |
Especifica se o redirecionamento de cartões inteligentes é permitido. |
| SasSequence |
Leitura/gravação |
Especifica a sequência de acesso seguro que o cliente usará para acessar a tela de logon no servidor. |
| ScaleBitmapCachesByBPP |
Leitura/gravação |
Não há suporte a esta propriedade. |
| ShadowBitmap |
Leitura/gravação |
Não há suporte a esta propriedade. Windows Vista: Especifica se bitmaps de sombra devem ser usados. |
| Shutdowntimeout |
Leitura/gravação |
Especifica o período de tempo, em segundos, para aguardar até que o servidor responda a uma solicitação de desconexão. O valor padrão da propriedade é 10. O valor máximo válido da propriedade é 600, que representa 10 minutos. Se o servidor não responder dentro do tempo especificado, o controle do cliente será desconectado. |
| singleConnectionTimeout |
Leitura/gravação |
Especifica o período máximo de tempo, em segundos, que o controle do cliente aguarda uma conexão com um endereço IP. Durante a conexão, o controle pode tentar se conectar a vários endereços IP. O valor máximo válido dessa propriedade é 600. Uma propriedade relacionada é overallConnectionTimeout. |
| SmartSizing |
Leitura/gravação |
Especifica se a exibição deve ser dimensionada para se ajustar à área do cliente do controle. VARIANT_TRUE habilita o dimensionamento. Observe que as barras de rolagem não aparecem quando a propriedade SmartSizing está habilitada. |
| SmoothScroll |
Leitura/gravação |
Não há suporte a esta propriedade. |
| Transporttype |
Leitura/gravação |
Especifica o tipo de transporte usado pelo cliente. Essa propriedade não é usada pelo controle ActiveX da Área de Trabalho Remota. |
| WinCEFixedPalette |
Leitura/gravação |
Válido apenas para Windows CE. |
Comentários
Essa interface foi estendida pelas seguintes interfaces, com cada nova interface herdando todos os métodos e propriedades das interfaces anteriores:
- IMsRdpClientAdvancedSettings2
- IMsRdpClientAdvancedSettings3
- IMsRdpClientAdvancedSettings4
- IMsRdpClientAdvancedSettings5
- IMsRdpClientAdvancedSettings6
- IMsRdpClientAdvancedSettings7
- IMsRdpClientAdvancedSettings8
Essa propriedade não pode ser definida quando o controle está conectado, a menos que indicado de outra forma.
Para obter mais informações sobre a Conexão da Web da Área de Trabalho Remota, consulte Requisitos para conexão da Web da Área de Trabalho Remota.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Biblioteca de tipos |
|
| DLL |
|
| IID |
IID_IMsRdpClientAdvancedSettings é definido como 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2 |
Confira também
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