Classe MsRdpClient

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

Essa classe implementa as interfaces a seguir.

• Imsrdpclient
• Imstscax
• IDispatch
• Imstscaxevents
• Imstscnonscriptable
• IMsRdpClientNonScriptable

MsRdpClient tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

A classe MsRdpClient tem esses métodos.

Método	Descrição
Conectar	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.
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 MsRdpClient 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.
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.
ConnectingText	Leitura/gravação	O texto que aparece centralizado no controle enquanto o controle está se conectando.
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.
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.
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.
HorizontalScrollBarVisible	Somente leitura	Indica se o controle exibiu uma barra de rolagem horizontal.
PortablePassword	Leitura/gravação	Não há suporte a esta propriedade.
PortableSalt	Leitura/gravação	Não há suporte a esta propriedade.
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 do cliente.
SecuredSettingsEnabled	Somente leitura	Indica se a interface IMsTscSecuredSettings está disponível.
Servidor	Leitura/gravação	O nome do servidor ao qual o controle atual está conectado.
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.
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.

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
CLSID	CLSID_MsRdpClient é definido como 791fa017-2de3-492e-acc5-53c67a2b94d0

Confira também

Classes de controle ActiveX da Área de Trabalho Remota