Compartilhar via

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

  • Artigo

[A interface IRDPSRAPIViewer não está mais disponível para uso para aplicativos UWP a partir do Windows 10, versão 1709. Ele ainda tem suporte para aplicativos da área de trabalho.]

Inicia um ouvinte para aceitar conexões inversas do participante do compartilhamento para o visualizador ou obtém a cadeia de conexão que o participante do compartilhamento usa para se conectar inversamente ao visualizador.

Sintaxe

HRESULT StartReverseConnectListener(
  [in]  BSTR bstrConnectionString,
  [in]  BSTR bstrUserName,
  [in]  BSTR bstrPassword,
  [out] BSTR *pbstrReverseConnectString
);

Parâmetros

[in] bstrConnectionString

Tipo: BSTR

A cadeia de conexão que o participante do compartilhamento usará para iniciar o ouvinte.

[in] bstrUserName

Tipo: BSTR

O nome de usuário a ser usado para autenticação.

[in] bstrPassword

Tipo: BSTR

A senha a ser usada para autenticação.

[out] pbstrReverseConnectString

Tipo: BSTR*

Um ponteiro para um BSTR que recebe a cadeia de conexão que o participante do compartilhamento pode usar para fazer a conexão inversa ao visualizador usando o método IRDPSRAPISharingSession::ConnectToClient .

Valor retornado

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

Esse método é usado para executar duas operações separadas:

  • A primeira é permitir que o visualizador obtenha a cadeia de conexão que o participante do compartilhamento usa para se conectar ao visualizador. Para fazer isso, os parâmetros bstrConnectionString, bstrUserName e bstrPassword devem ser NULL. Em seguida, o visualizador envia essa cadeia de conexão para o participante do compartilhamento em um método definido pelo aplicativo, como armazenar a cadeia de conexão em um arquivo e compartilhar o arquivo com o participante do compartilhamento.
  • A segunda operação é iniciar um ouvinte que watch para tentativas de conexão inversa do participante do compartilhamento. Para essa operação, o parâmetro pbstrReverseConnectString deve ser NULL.
A sequência normal de eventos para este procedimento é a seguinte:
  1. O visualizador obtém sua cadeia de conexão chamando o método StartReverseConnectListener , passando NULL para os parâmetros bstrConnectionString, bstrUserName e bstrPassword .
  2. O visualizador inicia um ouvinte de conexão reversa chamando o método StartReverseConnectListener , passando NULL para o parâmetro pbstrReverseConnectString e valores válidos para os parâmetros bstrConnectionString, bstrUserName e bstrPassword .
  3. O visualizador envia a cadeia de conexão obtida na etapa 1 para o participante do compartilhamento.

Requisitos

   
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