Condividi tramite

Metodo IRDPSRAPIViewer::StartReverseConnectListener (rdpencomapi.h)

  • Articolo

[L'interfaccia IRDPSRAPIViewer non è più disponibile per l'uso per le applicazioni UWP a partire da Windows 10 versione 1709. È ancora supportato per le app desktop.

Avvia un listener per accettare connessioni inverse dal condivisore al visualizzatore oppure ottiene la stringa di connessione usata dal condivisore per invertire la connessione al visualizzatore.

Sintassi

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

Parametri

[in] bstrConnectionString

Tipo: BSTR

Stringa di connessione che verrà usata dal condivisore per avviare il listener.

[in] bstrUserName

Tipo: BSTR

Nome utente da usare per l'autenticazione.

[in] bstrPassword

Tipo: BSTR

Password da usare per l'autenticazione.

[out] pbstrReverseConnectString

Tipo: BSTR*

Puntatore a un BSTR che riceve la stringa di connessione che il condivisore può usare per invertire la connessione al visualizzatore usando il metodo IRDPSRAPISharingSession::ConnectToClient .

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene S_OK. In caso contrario, il valore restituito è un codice di errore.

Commenti

Questo metodo viene usato per eseguire due operazioni separate:

  • Il primo consiste nel consentire al visualizzatore di ottenere la stringa di connessione usata dal condivisore per invertire la connessione al visualizzatore. A tale scopo, i parametri bstrConnectionString, bstrUserName e bstrPassword devono essere tutti NULL. Il visualizzatore invia quindi questa stringa di connessione al condivisore in un metodo definito dall'applicazione, ad esempio archiviando la stringa di connessione in un file e condividendo il file con il condivisore.
  • La seconda operazione consiste nell'avviare un listener che watch per i tentativi di connessione inversa dal condivisore. Per questa operazione, il parametro pbstrReverseConnectString deve essere NULL.
La sequenza normale di eventi per questa procedura è la seguente:
  1. Il visualizzatore ottiene la stringa di connessione chiamando il metodo StartReverseConnectListener , passando NULL per i parametri bstrConnectionString, bstrUserName e bstrPassword .
  2. Il visualizzatore avvia un listener di connessione inversa chiamando il metodo StartReverseConnectListener , passando NULL per il parametro pbstrReverseConnectString e i valori validi per i parametri bstrConnectionString, bstrUserName e bstrPassword .
  3. Il visualizzatore invia la stringa di connessione ottenuta nel passaggio 1 al condivisore.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione rdpencomapi.h
DLL RdpEncom.dll

Vedi anche

IRDPSRAPIViewer