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 |