Classe MsRdpClient5

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

Essa classe implementa as interfaces a seguir.

MsRdpClient5 tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe MsRdpClient5 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.
GetErrorDescription	Recupera os códigos de erro e as mensagens de erro.
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 MsRdpClient5 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.
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.
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 disponíveis 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.
HorizontalScrollBarVisible	Somente leitura	Indica se o controle exibiu uma barra de rolagem horizontal.
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 a SSL (Secure Sockets Layer) está habilitada 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.
RedirectDynamicDevices	Leitura/gravação	Especifica se os dispositivos PnP anexados dinamicamente que são enumerados durante uma sessão estão disponíveis para redirecionamento.
RedirectDynamicDrives	Leitura/gravação	Especifica se as unidades PnP anexadas dinamicamente que são enumeradas durante uma sessão estão disponíveis para redirecionamento.
RemoteProgram	Somente leitura	A configuração do RemoteApp do cliente.
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.
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.
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.
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.
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 Vista
Servidor mínimo com suporte	Windows Server 2008
Biblioteca de tipos	MsTscAx.dll
DLL	MsTscAx.dll
CLSID	CLSID_MsRdpClient5 é definido como 4EB89FF4-7F78-4A0F-8B8D-2BF02E94E4B2

Confira também

Classes de controle ActiveX da Área de Trabalho Remota

Comentários

Esta página foi útil?

Last updated on 2023-08-19