Partilhar via


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:

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
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsRdpClientAdvancedSettings é definido como 3c65b4ab-12b3-465b-acd4-b8dad3bff9e2

Confira também

Referência de conexão da Web da Área de Trabalho Remota

Imstscadvancedsettings