Classe MsRdpClient7

Controle do Cliente RDP da Microsoft (redistribuível) – versão 8

Essa classe implementa as interfaces a seguir.

• IMsRdpClient7
• IMsRdpClient6
• IMsRdpClient5
• IMsRdpClient4
• IMsRdpClient3
• IMsRdpClient2
• Imsrdpclient
• Imstscax
• IDispatch
• Imstscaxevents
• Imstscnonscriptable
• IMsRdpClientNonScriptable
• IMsRdpClientNonScriptable2
• IMsRdpClientNonScriptable3
• IMsRdpClientNonScriptable4
• IMsRdpClientNonScriptable5
• IMsRdpPreferredRedirectionInfo

MsRdpClient7 tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

A classe MsRdpClient7 tem esses métodos.

Método	Descrição
Connect	Inicia uma conexão usando as propriedades definidas no momento no controle .
CreateVirtualChannels	Cria um objeto de canal virtual do lado do cliente para cada nome de canal virtual especificado.
Desconectar	Desconecta a conexão ativa.
GetErrorDescription	Recupera os códigos de erro e as mensagens de erro.
GetStatusText	Recupera o texto status para o código de status especificado.
GetVirtualChannelOptions	Recupera as opções definidas para um canal virtual.
NotifyRedirectDeviceChange	Notifica o módulo de redirecionamento de dispositivo do controle ActiveX da Área de Trabalho Remota de que ocorreu uma alteração de dispositivo no sistema. Esse método passa WM_DEVICECHANGE notificações para o controle.
OnAuthenticationWarningDismissed	Chamado depois que um controle ActiveX exibe uma caixa de diálogo de autenticação (por exemplo, a caixa de diálogo de erro de certificado).
OnAuthenticationWarningDisplayed	Chamado antes de um controle ActiveX exibir uma caixa de diálogo de autenticação (por exemplo, a caixa de diálogo de erro de certificado).
OnAutoReconnected	Chamado quando o controle do cliente se reconecta automaticamente a uma sessão remota.
OnAutoReconnecting	Chamado quando um cliente está no processo de reconectar automaticamente uma sessão com um servidor Host de Sessão de Área de Trabalho Remota.
OnAutoReconnecting2	Chamado quando um cliente está no processo de reconectar automaticamente uma sessão com um servidor Host de Sessão de Área de Trabalho Remota.
OnChannelReceivedData	Chamado quando o cliente recebe dados em um canal virtual com script.
OnConfirmClose	Chamado quando o cliente chama o método IMsRdpClient::RequestClose .
OnConnected	Chamado quando o controle do cliente está no processo de estabelecer uma conexão com um servidor Host de Sessão de Área de Trabalho Remota.
OnConnecting	Chamado quando o controle do cliente começa a se conectar a um servidor em resposta a uma chamada para IMsTscAx::Connect.
OnConnectionBarPullDown	Chamado quando o usuário arrasta para baixo na barra de conexão.
OnDevicesButtonPressed	Chamado quando o botão dispositivos na barra de conexão foi pressionado.
OnDisconnected	Chamado quando o controle do cliente foi desconectado do servidor host de sessão de área de trabalho remota.
OnEnterFullScreenMode	Chamado quando o cliente entra no modo de tela inteira. Por exemplo, esse evento é chamado quando o usuário pressiona a combinação de teclas de atalho do modo de tela inteira (CTRL+ALT+BREAK).
OnFatalError	Chamado quando o controle do cliente encontra um erro fatal.
OnFocusReleased	Chamado quando a combinação de teclas de foco de versão é pressionada. Por exemplo, esse evento é chamado quando o usuário pressiona a ctrl+alt+seta para a esquerda ou a combinação de teclas CTRL+ALT+SETA PARA A DIREITA.
OnIdleTimeoutNotification	Chamado quando não houve nenhuma entrada de mouse ou teclado pelo usuário durante o período de tempo definido pelo método IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout .
OnLeaveFullScreenMode	Chamado quando o cliente sai do modo de tela inteira. Por exemplo, esse evento é chamado quando o usuário pressiona a combinação de teclas de atalho do modo de tela inteira (CTRL+ALT+BREAK).
OnLoginComplete	Chamado quando o controle do cliente fez logon com êxito em um servidor Host de Sessão de Área de Trabalho Remota, seguindo a exibição da caixa de diálogo Logon do Windows.
OnLogonError	Chamado quando ocorre um erro de logon ou outro evento de logon.
OnMouseInputModeChanged	Chamado quando o modo de entrada do mouse foi alterado.
OnNetworkStatusChanged	Chamado quando o status de rede foi alterado.
OnReceivedTSPublicKey	Chamado durante a sequência de conexão quando o cliente recupera a chave pública do servidor. Esse evento só será chamado se a propriedade NotifyTSPublicKey for VARIANT_TRUE.
OnRemoteDesktopSizeChange	Chamado para indicar que o tamanho do controle do cliente na área de trabalho remota foi alterado em resposta a uma operação de controle do cliente.
OnRemoteProgramDisplayed	Chamado quando um programa RemoteApp é exibido.
OnRemoteProgramResult	Chamado quando um programa RemoteApp retorna um resultado para o controle do cliente.
OnRemoteWindowDisplayed	Chamado quando uma janela RemoteApp é exibida.
OnRequestContainerMinimize	Chamado quando o usuário pressiona o botão Minimizar na barra de conexão no modo de tela inteira. O disparo desse evento é uma solicitação que o aplicativo de contêiner minimiza a si mesmo.
OnRequestGoFullScreen	Chamado quando o cliente solicita mudar para o modo de tela inteira e o método IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen é chamado para definir a propriedade ContainerHandledFullScreen como um valor diferente de zero.
OnRequestLeaveFullScreen	Chamado quando o cliente solicita sair do modo de tela inteira e a propriedade IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen foi definida como um valor diferente de zero.
OnServiceMessageReceived	Chamado quando o cliente recebe uma mensagem do sistema.
OnUserNameAcquired	Chamado quando o nome de usuário foi adquirido pelo controle .
OnWarning	Chamado quando o controle do cliente encontra uma condição de erro que não é fatal.
RequestClose	Solicita um desligamento normal do controle do cliente.
Resetpassword	Redefine todos os estados de senha no controle .
SendKeys	Envia uma série de pressionamentos de teclas para o controle. Os pressionamentos de tecla estão no formulário de código de verificação, que são os dados de teclado das teclas físicas reais.
SendOnVirtualChannel	Envia dados para o servidor Host da Sessão de Área de Trabalho Remota por meio de um canal virtual que foi criado anteriormente usando o método IMsTscAx::CreateVirtualChannels .
SetVirtualChannelOptions	Define as opções de canal virtual para o controle do cliente.

Propriedades

A classe MsRdpClient7 tem essas propriedades.

Propriedade	Tipo de acesso	Descrição
AdvancedSettings	Somente leitura	Um ponteiro de interface IMsTscAdvancedSettings .
AdvancedSettings2	Somente leitura	Ponteiro para a interface IMsRdpClientAdvancedSettings , usada para definir configurações avançadas para o controle do cliente.
AdvancedSettings3	Somente leitura	Ponteiro para a interface IMsRdpClientAdvancedSettings2 , usada para definir configurações avançadas para o controle do cliente.
AdvancedSettings4	Somente leitura	Ponteiro para a interface IMsRdpClientAdvancedSettings3 , usada para definir configurações avançadas para o controle do cliente.
AdvancedSettings5	Somente leitura	Um ponteiro de interface IMsRdpClientAdvancedSettings4 .
AdvancedSettings6	Somente leitura	A interface para IMsRdpClientAdvancedSettings5.
AdvancedSettings7	Somente leitura	A interface para IMsRdpClientAdvancedSettings6.
AdvancedSettings8	Somente leitura	Um objeto que dá suporte à interface IMsRdpClientAdvancedSettings7 .
AllowCredentialSaving	Leitura/gravação	Especifica se a caixa de diálogo credenciais exibe uma caixa de marcar para habilitar o salvamento de credenciais.
AllowPromptingForCredentials	Leitura/gravação	Especifica se o controle ActiveX da Área de Trabalho Remota pode solicitar credenciais ao usuário.
BinaryPassword	Leitura/gravação	Não há suporte a esta propriedade.
BinarySalt	Leitura/gravação	Não há suporte a esta propriedade.
CipherStrength	Somente leitura	A força máxima de criptografia do controle atual.
ClearTextPassword	Somente gravação	A senha de controle ActiveX da Área de Trabalho Remota, em formato de texto sem formatação.
ColorDepth	Leitura/gravação	Profundidade de cor do controle atual.
Conectado	Somente leitura	O estado de conexão do controle atual.
ConnectedStatusText	Leitura/gravação	Texto exibido na área do cliente do controle enquanto o controle está no estado conectado.
ConnectingText	Leitura/gravação	O texto que aparece centralizado no controle enquanto o controle está se conectando.
ConnectionBarText	Leitura/gravação	A cadeia de caracteres de texto a ser exibida para a barra de conexão.
DesktopHeight	Leitura/gravação	A altura do controle atual, em pixels, na área de trabalho remota inicial.
DesktopWidth	Leitura/gravação	A largura do controle atual, em pixels, na área de trabalho remota inicial.
DeviceCollection	Somente leitura	A coleção de dispositivos PnP que estão disponíveis para redirecionamento.
DisableConnectionBar	Somente gravação	Especifica se o controle ActiveX da Área de Trabalho Remota deve desabilitar a barra de conexão.
DisableRemoteAppCapsCheck	Leitura/gravação	Especifica se o controle ActiveX da Área de Trabalho Remota não deve marcar o servidor para recursos do RemoteApp.
DisconnectedText	Leitura/gravação	O texto que aparece centralizado no controle antes de uma conexão ser encerrada.
Domínio	Leitura/gravação	O domínio no qual o usuário atual faz logon.
DriveCollection	Somente leitura	A coleção de unidades de disco que está disponível para redirecionamento.
EnableCredSspSupport	Leitura/gravação	Especifica se o CredSSP está habilitado para essa conexão.
ExtendedDisconnectReason	Somente leitura	Informações estendidas sobre o motivo da desconexão do controle do cliente.
FullScreen	Leitura/gravação	Indica se o controle está no modo de tela inteira.
FullScreenTitle	Somente gravação	O título da janela exibido quando o controle está no modo de tela inteira.
GetRemoteMonitorsBoundingBox	Somente leitura	Especifica o retângulo delimitador do monitor remoto.
HorizontalScrollBarVisible	Somente leitura	Indica se o controle exibiu uma barra de rolagem horizontal.
LaunchedViaClientShellInterface	Leitura/gravação	Especifica se o usuário iniciou o controle de cliente usando a interface de Acesso via Web da Área de Trabalho Remota.
MarkRdpSettingsSecure	Leitura/gravação	Especifica se as configurações de RDP são marcadas como seguras.
MsRdpClientShell	Somente leitura	As configurações do cliente para o inicializador do portal da Web.
NegotiateSecurityLayer	Leitura/gravação	Especifica se a configuração NegotiateSecurityLayer tem suporte para essa conexão. Nota: Quando CredSspSupport está habilitado e presente no cliente ou quando o Protocolo SSL está habilitado com a autenticação do usuário, NegotiateSecurityLayer é ignorado.
PortablePassword	Leitura/gravação	Não há suporte a esta propriedade.
PortableSalt	Leitura/gravação	Não há suporte a esta propriedade.
PromptForCredentials	Leitura/gravação	Especifica se a caixa de diálogo de solicitação de credenciais deve ser mostrada.
PromptForCredsOnClient	Leitura/gravação	Especifica se o controle do cliente exibe uma caixa de diálogo que solicita credenciais.
PublisherCertificateChain	Leitura/gravação	Especifica a cadeia de certificados do editor. A cadeia é armazenada em uma variante do tipo VT_BYREF que contém um ponteiro para uma estrutura CERT_CHAIN_CONTEXT .
RedirectDynamicDevices	Leitura/gravação	Especifica se os dispositivos PnP conectados dinamicamente que são enumerados durante uma sessão estão disponíveis para redirecionamento.
RedirectDynamicDrives	Leitura/gravação	Especifica se unidades PnP anexadas dinamicamente que são enumeradas durante uma sessão estão disponíveis para redirecionamento.
RedirectionWarningType	Leitura/gravação	Controla a presença e a aparência da caixa de diálogo de redirecionamento.
RemoteMonitorCount	Somente leitura	Especifica o número de monitores remotos.
RemoteMonitorLayoutMatchesLocal	Somente leitura	Especifica se o layout do monitor remoto é idêntico ao layout do monitor local.
RemoteProgram	Somente leitura	A configuração do RemoteApp do cliente.
RemoteProgram2	Somente leitura	Um objeto que dá suporte à interface ITSRemoteProgram2 .
SecuredSettings	Somente leitura	Um ponteiro de interface IMsTscSecuredSettings .
SecuredSettings2	Somente leitura	Ponteiro para a interface IMsRdpClientSecuredSettings , usada para definir configurações protegidas para o controle de cliente.
SecuredSettings3	Somente leitura	Um objeto que dá suporte à interface IMsRdpClientSecuredSettings2 .
SecuredSettingsEnabled	Somente leitura	Indica se a interface IMsTscSecuredSettings está disponível.
Server	Leitura/gravação	O nome do servidor ao qual o controle atual está conectado.
ShowRedirectionWarningDialog	Leitura/gravação	Especifica se a caixa de diálogo de aviso de segurança de redirecionamento deve ser mostrada antes de iniciar uma sessão.
StartConnected	Leitura/gravação	Indica se o controle estabelecerá a conexão do servidor Host da Sessão de Área de Trabalho Remota imediatamente após a inicialização.
TransportSettings	Somente leitura	A configuração do Gateway de Área de Trabalho Remota do cliente.
TransportSettings2	Somente leitura	A interface para IMsRdpClientTransportSettings2.
TransportSettings3	Somente leitura	Um objeto que dá suporte à interface IMsRdpClientTransportSettings3 .
TrustedZoneSite	Leitura/gravação	Especifica se o site do qual o usuário iniciou a conexão está na lista de sites confiáveis do computador cliente.
UIParentWindowHandle	Leitura/gravação	O identificador de janela para ser a janela pai do controle. Isso permite que todas as janelas exibidas pelo controle sejam corretamente modais em relação a todas as janelas exibidas pelo aplicativo pai.
UseMultimon	Leitura/gravação	Especifica se o controle ActiveX da Área de Trabalho Remota deve usar vários monitores.
UseRedirectionServerName	Leitura/gravação	Se deseja usar o nome do servidor de redirecionamento.
Username	Leitura/gravação	A credencial de logon de nome de usuário.
Versão	Somente leitura	O número de versão do controle atual.
VerticalScrollBarVisible	Somente leitura	Indica se o controle exibe uma barra de rolagem vertical.
WarnAboutClipboardRedirection	Leitura/gravação	Especifica se a caixa de diálogo de aviso de segurança deve incluir um aviso sobre o redirecionamento da área de transferência antes de iniciar uma sessão.
WarnAboutDirectXRedirection	Leitura/gravação	Essa propriedade não é usada.
WarnAboutPrinterRedirection	Leitura/gravação	Especifica se a caixa de diálogo de redirecionamento exibe uma mensagem sobre o redirecionamento da impressora antes de iniciar uma sessão.
WarnAboutSendingCredentials	Leitura/gravação	Especifica se o aviso de segurança deve incluir um aviso sobre o envio de credenciais para o servidor remoto antes de iniciar uma sessão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Biblioteca de tipos	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient7 é definido como A9D7038D-B5ED-472E-9C47-94BEA90A5910

Confira também

Classes de controle ActiveX da Área de Trabalho Remota