Freigeben über

IWTSProtocolConnection-Schnittstelle (wtsprotocol.h)

  • Artikel

[IWTSProtocolConnection ist ab Windows Server 2012 nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection.]

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 IWTSProtocolConnection-Objekt erstellen und es durch Aufrufen der OnConnected-Methode an den Remotedesktopdienstedienst übergeben. Als Antwort fügt der Dienst einen Verweis auf das IWTSProtocolConnectionCallback-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.

  1. GetLogonErrorRedirector
  2. SendPolicyData
  3. AcceptConnection
  4. GetClientData
  5. GetUserCredentials
  6. GetLicenseConnection
  7. AuthenticateClientToSession
  8. NotifySessionId
  9. GetProtocolHandles
  10. ConnectNotify
  11. IsUserAllowedToLogon
  12. SessionArbitrationEnumeration
  13. LogonNotify
  14. GetUserData
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:
  1. DisconnectNotify (Wird für die neue Sitzung aufgerufen, die erstellt wurde.)
  2. NotifySessionId (Wird für die vorhandene Sitzung aufgerufen.)
  3. GetProtocolHandles
  4. ConnectNotify
  5. LogonNotify
Um die Verbindung zu trennen, ruft der Remotedesktopdienstedienst die folgenden Methoden in der aufgeführten Reihenfolge auf:
  1. DisconnectNotify
  2. Schließen
Der Remotedesktopdienstedienst kann die folgenden Methoden jederzeit aufrufen, nachdem eine Verbindung hergestellt wurde:

Vererbung

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

Methoden

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

 
IWTSProtocolConnection::AcceptConnection

IWTSProtocolConnection::AcceptConnection ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::AcceptConnection.
IWTSProtocolConnection::AuthenticateClientToSession

IWTSProtocolConnection::AuthenticateClientToSession ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::AuthenticateClientToSession.
IWTSProtocolConnection::Close

IWTSProtocolConnection::Close ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::Close.
IWTSProtocolConnection::ConnectNotify

IWTSProtocolConnection::ConnectNotify ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::ConnectNotify.
IWTSProtocolConnection::CreateVirtualChannel

IWTSProtocolConnection::CreateVirtualChannel ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::CreateVirtualChannel.
IWTSProtocolConnection::D isconnectNotify

IWTSProtocolConnection::D isconnectNotify ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::D isconnectNotify.
IWTSProtocolConnection::GetClientData

IWTSProtocolConnection::GetClientData ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::GetClientData.
IWTSProtocolConnection::GetLastInputTime

IWTSProtocolConnection::GetLastInputTime ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::GetLastInputTime.
IWTSProtocolConnection::GetLicenseConnection

IWTSProtocolConnection::GetLicenseConnection ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::GetLicenseConnection.
IWTSProtocolConnection::GetLogonErrorRedirector

IWTSProtocolConnection::GetLogonErrorRedirector ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::GetLogonErrorRedirector.
IWTSProtocolConnection::GetProtocolHandles

IWTSProtocolConnection::GetProtocolHandles ist nicht mehr verfügbar.
IWTSProtocolConnection::GetProtocolStatus

IWTSProtocolConnection::GetProtocolStatus ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::GetProtocolStatus.
IWTSProtocolConnection::GetShadowConnection

IWTSProtocolConnection::GetShadowConnection ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::GetShadowConnection.
IWTSProtocolConnection::GetUserCredentials

IWTSProtocolConnection::GetUserCredentials ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::GetUserCredentials.
IWTSProtocolConnection::GetUserData

IWTSProtocolConnection::GetUserData ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolSettings::MergeSettings.
IWTSProtocolConnection::IsUserAllowedToLogon

IWTSProtocolConnection::IsUserAllowedToLogon ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::IsUserAllowedToLogon.
IWTSProtocolConnection::LogonNotify

IWTSProtocolConnection::LogonNotify ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::LogonNotify.
IWTSProtocolConnection::NotifySessionId

IWTSProtocolConnection::NotifySessionId ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::NotifySessionId.
IWTSProtocolConnection::QueryProperty

IWTSProtocolConnection::QueryProperty ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::QueryProperty.
IWTSProtocolConnection::SendBeep

IWTSProtocolConnection::SendBeep ist nicht mehr verfügbar.
IWTSProtocolConnection::SendPolicyData

IWTSProtocolConnection::SendPolicyData ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolManager::NotifySettingsChange.
IWTSProtocolConnection::SessionArbitrationEnumeration

IWTSProtocolConnection::SessionArbitrationEnumeration ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::SessionArbitrationEnumeration.
IWTSProtocolConnection::SetErrorInfo

IWTSProtocolConnection::SetErrorInfo ist nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolConnection::SetErrorInfo.

Anforderungen

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