Freigeben über

IRDPSRAPIViewer::StartReverseConnectListener-Methode (rdpencomapi.h)

  • Artikel

[Die IRDPSRAPIViewer-Schnittstelle ist ab Windows 10 Version 1709 nicht mehr für UWP-Anwendungen verfügbar. Es wird weiterhin für Desktop-Apps unterstützt.]

Initiiert einen Listener für das Akzeptieren umgekehrter Verbindungen vom Sharer zum Viewer oder ruft die Verbindungszeichenfolge ab, die der Freigabeanbieter zum Umkehren der Verbindung mit dem Viewer verwendet.

Syntax

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

Parameter

[in] bstrConnectionString

Typ: BSTR

Die Verbindungszeichenfolge, die der Sharer zum Starten des Listeners verwendet.

[in] bstrUserName

Typ: BSTR

Der Benutzername, der für die Authentifizierung verwendet werden soll.

[in] bstrPassword

Typ: BSTR

Das Kennwort, das für die Authentifizierung verwendet werden soll.

[out] pbstrReverseConnectString

Typ: BSTR*

Ein Zeiger auf einen BSTR , der die Verbindungszeichenfolge empfängt, die der Sharer verwenden kann, um die Verbindung mit dem Viewer mithilfe der IRDPSRAPISharingSession::ConnectToClient-Methode rückgängig zu machen.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls ist der Rückgabewert ein Fehlercode.

Hinweise

Diese Methode wird verwendet, um zwei separate Vorgänge auszuführen:

  • Die erste besteht darin, dem Viewer das Abrufen der Verbindungszeichenfolge zu ermöglichen, die der Sharer zum Umkehren der Verbindung mit dem Viewer verwendet. Dazu müssen die Parameter bstrConnectionString, bstrUserName und bstrPasswordnull sein. Der Viewer sendet dann diese Verbindungszeichenfolge in einer anwendungsdefinierten Methode an den Freigabegeber, z. B. speichern Sie die Verbindungszeichenfolge in einer Datei und teilen Sie die Datei mit dem Sharer.
  • Der zweite Vorgang besteht darin, einen Listener zu initiieren, der für Umgekehrte Verbindungsversuche vom Sharer watch wird. Für diesen Vorgang muss der pbstrReverseConnectString-ParameterNULL sein.
Die normale Abfolge von Ereignissen für diese Prozedur sieht wie folgt aus:
  1. Der Viewer ruft seine Verbindungszeichenfolge ab, indem er die StartReverseConnectListener-Methode aufruft und NULL für die Parameter bstrConnectionString, bstrUserName und bstrPassword übergibt.
  2. Der Viewer initiiert einen Reverse connect-Listener, indem er die StartReverseConnectListener-Methode aufruft und NULL für den PbstrReverseConnectString-Parameter und gültige Werte für die Parameter bstrConnectionString, bstrUserName und bstrPassword übergibt.
  3. Der Viewer sendet die in Schritt 1 abgerufene Verbindungszeichenfolge an den Sharer.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile rdpencomapi.h
DLL RdpEncom.dll

Weitere Informationen

IRDPSRAPIViewer