Interface IMsRdpClient8
Fornece os métodos e as propriedades necessários para configurar e usar o controle do cliente. Deriva da interface IMsRdpClient7 .
Membros
A interface IMsRdpClient8 herda de IMsRdpClient7. IMsRdpClient8 também tem estes tipos de membros:
Métodos
A interface IMsRdpClient8 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 a descrição do erro para os eventos de desconexão de sessão. |
| GetStatusText | Recupera o texto status para o código de status especificado. |
| GetVirtualChannelOptions | Recupera as opções definidas para um canal virtual. |
| Reconectar | Reconecta-se à sessão remota com a nova largura e altura da área de trabalho. |
| RequestClose | Solicita um desligamento normal do controle ActiveX da Área de Trabalho Remota. |
| 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 CreateVirtualChannels . |
| SendRemoteAction | Faz com que uma ação seja executada na sessão remota. |
| SetVirtualChannelOptions | Define as opções de canal virtual para o controle ActiveX da Área de Trabalho Remota. |
Propriedades
A interface IMsRdpClient8 tem essas propriedades.
| Propriedade | Tipo de acesso | Descrição |
|---|---|---|
|
AdvancedSettings |
Somente leitura |
Recupera um ponteiro de interface IMsTscAdvancedSettings . |
|
AdvancedSettings2 |
Somente leitura |
Recupera um ponteiro para a interface IMsRdpClientAdvancedSettings . A interface pode ser usada para definir configurações avançadas para o controle do cliente. |
|
AdvancedSettings3 |
Somente leitura |
Recupera um ponteiro para a interface IMsRdpClientAdvancedSettings2 . A interface pode ser usada para definir configurações avançadas para o controle do cliente. |
|
AdvancedSettings4 |
Somente leitura |
Recupera um ponteiro para a interface IMsRdpClientAdvancedSettings3 . |
|
AdvancedSettings5 |
Somente leitura |
Recupera um ponteiro para uma interface IMsRdpClientAdvancedSettings4 . |
|
AdvancedSettings6 |
Somente leitura |
Recupera a interface IMsRdpClientAdvancedSettings5 . |
|
AdvancedSettings7 |
Somente leitura |
Recupera a interface IMsRdpClientAdvancedSettings6 . |
|
AdvancedSettings8 |
Somente leitura |
Recupera um objeto que dá suporte à interface IMsRdpClientAdvancedSettings7 . |
|
AdvancedSettings9 |
Somente leitura |
Contém um objeto que dá suporte à interface IMsRdpClientAdvancedSettings8 . |
|
CipherStrength |
Somente leitura |
Recupera a força máxima de criptografia do controle atual. |
|
ColorDepth |
Leitura/gravação |
A profundidade de cor (em bits por pixel) para a conexão do controle. |
|
Conectado |
Somente leitura |
Recupera o estado de conexão do controle atual. |
|
ConnectedStatusText |
Leitura/gravação |
Contém o texto exibido na área do cliente do controle enquanto o controle está no estado conectado. |
|
ConnectingText |
Leitura/gravação |
Especifica o texto que aparece centralizado no controle enquanto o controle está se conectando. |
|
DesktopHeight |
Leitura/gravação |
Especifica a altura do controle atual, em pixels, na área de trabalho remota inicial. |
|
DesktopWidth |
Leitura/gravação |
Especifica a largura do controle atual, em pixels, na área de trabalho remota inicial. |
|
DisconnectedText |
Leitura/gravação |
Especifica o texto que aparece centralizado no controle antes de uma conexão ser encerrada. |
|
Domínio |
Leitura/gravação |
Especifica o domínio no qual o usuário atual faz logon. |
|
ExtendedDisconnectReason |
Somente leitura |
Contém informações estendidas sobre o motivo da desconexão do controle. |
|
FullScreen |
Leitura/gravação |
Determina se o controle do cliente está no modo de tela inteira. |
|
FullScreenTitle |
Somente gravação |
Especifica 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 |
Recupera a interface de configuração de cliente com script IMsRdpClientShell. |
|
RemoteProgram |
Somente leitura |
Recupera um objeto que dá suporte à interface ITSRemoteProgram . |
|
RemoteProgram2 |
Somente leitura |
Recupera um objeto que dá suporte à interface ITSRemoteProgram2 . |
|
SecuredSettings |
Somente leitura |
Recupera um ponteiro de interface IMsTscSecuredSettings . |
|
SecuredSettings2 |
Somente leitura |
Recupera um ponteiro para a interface IMsRdpClientSecuredSettings . Essa interface pode ser usada para definir configurações protegidas para o controle de cliente. |
|
SecuredSettings3 |
Somente leitura |
Recupera um objeto que dá suporte à interface IMsRdpClientSecuredSettings2 . |
|
SecuredSettingsEnabled |
Somente leitura |
Indica se a interface IMsTscSecuredSettings está disponível. Ou seja, se a página da Web que contém o controle está atualmente em uma das zonas de segurança de URL de Explorer da Internet permitidas. |
|
Servidor |
Leitura/gravação |
Especifica 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. |
|
TransportSettings |
Somente leitura |
Recupera o que foi passado por meio de um script para a interface IMsRdpClientTransportSettings . |
|
TransportSettings2 |
Somente leitura |
Recupera a interface IMsRdpClientTransportSettings2 . |
|
TransportSettings3 |
Somente leitura |
Recupera um objeto que dá suporte à interface IMsRdpClientTransportSettings3 . |
|
Username |
Leitura/gravação |
Especifica a credencial de logon de nome de usuário. |
|
Versão |
Somente leitura |
Especifica o número de versão do controle atual. |
|
VerticalScrollBarVisible |
Somente leitura |
Indica se o controle exibe uma barra de rolagem vertical. |
Comentários
A interface IMsRdpClient8 foi estendida pelas seguintes interfaces, com cada nova interface herdando todos os métodos e propriedades das interfaces anteriores:
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 8 |
| Servidor mínimo com suporte |
Windows Server 2012 |
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient10 é definido como C0EFA91A-EEB7-41C7-97FA-F0ED645EFB24 CLSID_MsRdpClient10NotSafeForScripting é definido como A0C63C30-F08D-4AB4-907C-34905D770C7D CLSID_MsRdpClient8 é definido como 5F681803-2900-4C43-A1CC-CF405404A676 CLSID_MsRdpClient8NotSafeForScripting é definido como A3BC03A0-041D-42E3-AD22-882B7865C9C5 CLSID_MsRdpClient9 é definido como 301B94BA-5D25-4A12-BFFE-3B6E7A616585 CLSID_MsRdpClient9NotSafeForScripting é definido como 8B918B82-7985-4C24-89DF-C33AD2BBFBCD |
| IID |
IID_IMsRdpClient8 é definido como 4247E044-9271-43A9-BC49-E2AD9E855D62 |