IWRdsProtocolConnection-Schnittstelle (wtsprotocol.h)

Artikel
03/04/2024

Macht Methoden verfügbar, die vom Remotedesktopdienstedienst aufgerufen werden, um eine Clientverbindung zu konfigurieren. Ihr Protokoll muss diese Schnittstelle implementieren, um Verbindungsanforderungen von Clients zu verarbeiten. Wenn der Protokolllistener eine Verbindungsanforderung von einem Client empfängt, muss er ein IWRdsProtocolConnection-Objekt erstellen und es durch Aufrufen der IWRdsProtocolListenerCallback::OnConnected-Methode an den Remotedesktopdienstedienst übergeben. Als Antwort fügt der Dienst einen Verweis auf das IWRdsProtocolConnectionCallback-Objekt hinzu und gibt einen Zeiger darauf zurück. Wenn die Verbindung nicht mehr benötigt wird, muss das Protokoll den Zeiger freigeben.

Während einer Verbindungssequenz werden die folgenden Methoden vom Remotedesktopdienst in der angegebenen Reihenfolge aufgerufen.

Wenn der Remotedesktopdienst nach dem Aufruf von SessionArbitrationEnumeration erneut eine Verbindung herstellen muss, wird die Verbindung durch Aufrufen der folgenden Methoden in der angegebenen Reihenfolge wiederhergestellt:

DisconnectNotify (Wird für die neue Sitzung aufgerufen, die erstellt wurde.)
NotifySessionId (Wird für die vorhandene Sitzung aufgerufen.)
GetInputHandles
GetVideoHandle
ConnectNotify
LogonNotify

Um die Verbindung zu trennen, ruft der Remotedesktopdienstedienst die folgenden Methoden in der aufgeführten Reihenfolge auf:

Der Remotedesktopdienstedienst kann die folgenden Methoden jederzeit aufrufen, nachdem eine Verbindung hergestellt wurde:

Vererbung

Die IWRdsProtocolConnection-Schnittstelle erbt von der IUnknown-Schnittstelle . IWRdsProtocolConnection verfügt auch über folgende Membertypen:

Methoden

Die IWRdsProtocolConnection-Schnittstelle verfügt über diese Methoden.


IWRdsProtocolConnection::AcceptConnection Weist das Protokoll an, mit der Verbindungsanforderung fortzufahren.
IWRdsProtocolConnection::AuthenticateClientToSession Gibt eine Sitzung an, mit der die Verbindung wiederhergestellt werden soll.
IWRdsProtocolConnection::Close Schließt eine Verbindung, nachdem die Sitzung getrennt wurde.
IWRdsProtocolConnection::ConnectNotify Signalisiert dem Protokoll, dass die Sitzung initialisiert wurde.
IWRdsProtocolConnection::CreateVirtualChannel Fordert an, dass das Protokoll einen virtuellen Kanal erstellt.
IWRdsProtocolConnection::D isconnectNotify Benachrichtigt das Protokoll, dass die Sitzung getrennt wurde.
IWRdsProtocolConnection::GetClientData Fordert Clienteinstellungen vom Protokoll an.
IWRdsProtocolConnection::GetClientMonitorData Ruft die Anzahl der Monitore und die primäre Monitornummer auf dem Client ab.
IWRdsProtocolConnection::GetInputHandles Ruft die Handles für Eingabe-/Ausgabegeräte für das Protokoll ab.
IWRdsProtocolConnection::GetLastInputTime Ruft den Zeitpunkt ab, zu dem das Protokoll zuletzt eine Benutzereingabe empfangen hat.
IWRdsProtocolConnection::GetLicenseConnection Ruft ein IWRdsProtocolLicenseConnection-Objekt ab, das zum Starten des Clientlizenzierungsprozesses verwendet wird.
IWRdsProtocolConnection::GetLogonErrorRedirector Ruft eine IWRdsProtocolLogonErrorRedirector-Schnittstelle ab, die angibt, wie das Protokoll Clientanmeldefehler behandeln soll.
IWRdsProtocolConnection::GetProtocolStatus Ruft Informationen zum protokollspezifischen status ab.
IWRdsProtocolConnection::GetShadowConnection Ruft einen Verweis auf das Schattenverbindungsobjekt aus dem Protokoll ab.
IWRdsProtocolConnection::GetUserCredentials Gibt Benutzeranmeldeinformationen zurück.
IWRdsProtocolConnection::GetVideoHandle Ruft das Handle des Videogeräts für das Protokoll ab.
IWRdsProtocolConnection::IsUserAllowedToLogon Bestimmt anhand des Protokolls, ob sich ein Benutzer bei einer Sitzung anmelden darf.
IWRdsProtocolConnection::LogonNotify Wird aufgerufen, wenn sich der Benutzer bei der Sitzung angemeldet hat.
IWRdsProtocolConnection::NotifyCommandProcessCreated Benachrichtigt das Protokoll, dass der Winlogon.exe Prozess erstellt und initialisiert wurde.
IWRdsProtocolConnection::NotifySessionId Sendet den Bezeichner der neuen Sitzung an das Protokoll.
IWRdsProtocolConnection::P reDisconnect Benachrichtigt das Protokoll darüber, dass die Sitzung getrennt werden soll.
IWRdsProtocolConnection::QueryProperty Ruft einen Eigenschaftswert aus dem Protokoll ab.
IWRdsProtocolConnection::SessionArbitrationEnumeration Wird nach dem Schiedsverfahren aufgerufen, damit das Protokoll die Sitzungen angeben kann, die wiederhergestellt werden sollen.
IWRdsProtocolConnection::SetErrorInfo Legt Fehlerinformationen im Protokoll fest.

Hinweise

Um einen möglichen Deadlock beim Aufrufen einer der Methoden auf dieser Schnittstelle zu vermeiden, sollten Sie keine Funktions- oder Methodenaufrufe ausführen, die direkt oder indirekt dazu führen, dass eine Remotedesktopdienste-API aufgerufen wird. Wenn Sie einen ausgehenden Aufruf durchführen müssen, sollten Sie einen neuen Thread starten und den ausgehenden Aufruf aus dem neuen Thread ausführen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	wtsprotocol.h