Compartilhar via

Método IRDPSRAPIViewer::Connect (rdpencomapi.h)

  • Artigo

[A interface IRDPSRAPIViewer não está mais disponível para uso para aplicativos UWP a partir de Windows 10, versão 1709. Ainda há suporte para aplicativos da Área de Trabalho.]

Inicia a conexão real com o sharer.

Sintaxe

HRESULT Connect(
  [in] BSTR bstrConnectionString,
  [in] BSTR bstrName,
  [in] BSTR bstrPassword
);

Parâmetros

[in] bstrConnectionString

Tipo: BSTR

O cadeia de conexão usado para se conectar ao compartilhamento e autenticar o visualizador.

[in] bstrName

Tipo: BSTR

Nome do visualizador. O nome é enviado para o sharer e outros visualizadores. A cadeia de caracteres é limitada a 255 caracteres.

[in] bstrPassword

Tipo: BSTR

Senha usada para autenticação. A senha é enviada fora de banda do sharer.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o valor retornado será um código de erro.

Comentários

O cadeia de conexão contido no parâmetro bstrConnectionString é gerado pelo sharer e obtido pelo visualizador concluindo as seguintes etapas:

  1. O sharer obtém uma instância da interface IRDPSRAPIInvitationManager da propriedade IRDPSRAPISharingSession::Invitations .
  2. O sharer obtém uma instância da interface IRDPSRAPIInvitation chamando o método IRDPSRAPIInvitationManager::CreateInvitation .
  3. O sharer obtém o cadeia de conexão da propriedade IRDPSRAPIInvitation::ConnectionString.
  4. O sharer envia o cadeia de conexão para o visualizador em um método definido pelo aplicativo, como armazenar o cadeia de conexão em um arquivo e compartilhar o arquivo com o visualizador.
Para aumentar a segurança, os aplicativos podem associar senhas a um convite no lado do sharer. Essas senhas geralmente são distribuídas aos visualizadores por meio de algum mecanismo diferente daquele usado para enviar o cadeia de conexão. Isso é para evitar tipos de ataques de "detecção" de rede. Se um convite tiver uma senha associada a ele, a senha deverá ser passada por meio dessa API. Caso contrário, o participante será desconectado.

A cadeia de caracteres bstrName definida nesta propriedade é enviada ao sharer depois que a conexão é iniciada. A propriedade é um nome amigável que o aplicativo sharer pode optar por exibir. A propriedade é útil quando um convite é usado para autenticar vários participantes porque permite que o sharer e os outros visualizadores identifiquem quem está participando de uma sessão de Compartilhamento de Área de Trabalho do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rdpencomapi.h
DLL RdpEncom.dll

Confira também

IRDPSRAPIViewer