IWTSProtocolListener::StartListen-Methode (wtsprotocol.h)
[IWTSProtocolListener::StartListen ist ab Windows Server 2012 nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolListener::StartListen.]
Benachrichtigt das Protokoll, um mit dem Lauschen auf Clientverbindungsanforderungen zu beginnen.
Syntax
HRESULT StartListen(
[in] IWTSProtocolListenerCallback *pCallback
);
Parameter
[in] pCallback
Ein Zeiger auf ein IWTSProtocolListenerCallback-Objekt , das vom Remotedesktopdienst implementiert wird. Das Protokoll verwendet das IWTSProtocolListenerCallback-Objekt , um das
Remotedesktopdienstedienst zu eingehenden Verbindungsanforderungen. Das Protokoll muss einen Verweis auf dieses Objekt hinzufügen und freigeben, wenn StopListen aufgerufen wird.
Rückgabewert
Wenn Sie diese Methode implementieren, geben Sie S_OK zurück, wenn die Funktion erfolgreich ist. Wenn ein Fehler auftritt, geben Sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Hinweise
Die StartListen-Methode wird aufgerufen, wenn der Remotedesktopdienstedienst gestartet wird.
- Der Remotedesktopdienstedienst ruft CoCreateInstance auf, um ein IWTSProtocolManager-Objekt zu erstellen.
- Der Remotedesktopdienstedienst ruft CreateListener auf der IWTSProtocolManager-Schnittstelle auf. Das Protokoll erstellt ein IWTSProtocolListener-Objekt und übergibt es zurück an den Remotedesktopdienstedienst.
- Der Remotedesktopdienstedienst ruft StartListen für das IWTSProtocolListener-Objekt auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | wtsprotocol.h |