Freigeben über

IRDPSRAPIViewer::Connect-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.]

Startet die tatsächliche Verbindung mit dem Sharer.

Syntax

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

Parameter

[in] bstrConnectionString

Typ: BSTR

Die Verbindungszeichenfolge, die verwendet werden, um eine Verbindung mit dem Sharer herzustellen und den Viewer zu authentifizieren.

[in] bstrName

Typ: BSTR

Name für den Viewer. Der Name wird an den Sharer und andere Viewer gesendet. Die Zeichenfolge ist auf 255 Zeichen beschränkt.

[in] bstrPassword

Typ: BSTR

Kennwort, das für die Authentifizierung verwendet wird. Das Kennwort wird out-of-band vom Sharer gesendet.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die im bstrConnectionString-Parameter enthaltene Verbindungszeichenfolge wird vom Sharer generiert und vom Viewer durch Ausführen der folgenden Schritte abgerufen:

  1. Der Sharer ruft eine instance der IRDPSRAPIInvitationManager-Schnittstelle aus der IRDPSRAPISharingSession::Invitations-Eigenschaft ab.
  2. Der Sharer ruft eine instance der IRDPSRAPIInvitation-Schnittstelle ab, indem die IRDPSRAPIInvitationManager::CreateInvitation-Methode aufgerufen wird.
  3. Der Sharer ruft die Verbindungszeichenfolge aus der IRDPSRAPIInvitation::ConnectionString-Eigenschaft ab.
  4. Der Sharer sendet die Verbindungszeichenfolge in einer von der Anwendung definierten Methode an den Viewer, z. B. das Speichern des Verbindungszeichenfolge in einer Datei und das Freigeben der Datei für den Viewer.
Um die Sicherheit zu erhöhen, können Anwendungen Kennwörter einer Einladung auf der Sharerseite zuordnen. Solche Kennwörter werden normalerweise über einen anderen Mechanismus als den, der zum Senden der Verbindungszeichenfolge verwendet wird, an Die Betrachter verteilt. Dadurch soll verhindert werden, dass Netzwerkangriffe "erschnüffeln". Wenn einer Einladung ein Kennwort zugeordnet ist, muss das Kennwort über diese API übergeben werden. Andernfalls wird die Verbindung zwischen dem Teilnehmer getrennt.

Die in dieser Eigenschaft festgelegte bstrName-Zeichenfolge wird an den Sharer gesendet, nachdem die Verbindung gestartet wurde. Die Eigenschaft ist ein Anzeigename, den die Sharer-Anwendung anzeigen kann. Die -Eigenschaft ist nützlich, wenn eine Einladung zum Authentifizieren mehrerer Teilnehmer verwendet wird, da sie es dem Sharer und den anderen Viewern ermöglicht, zu identifizieren, wer an einer Windows-Desktopfreigabesitzung teilnimmt.

Anforderungen

Anforderung Wert
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