IWRdsProtocolListener::StartListen-Methode (wtsprotocol.h)
Benachrichtigt das Protokoll, um mit dem Lauschen auf Clientverbindungsanforderungen zu beginnen.
Syntax
HRESULT StartListen(
[in] IWRdsProtocolListenerCallback *pCallback
);
Parameter
[in] pCallback
Ein Zeiger auf ein IWRdsProtocolListenerCallback-Objekt , das vom Remotedesktopdienst implementiert wird. Das Protokoll verwendet das IWRdsProtocolListenerCallback-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 IWRdsProtocolManager-Objekt zu erstellen.
- Der Remotedesktopdienstedienst ruft CreateListener auf der IWRdsProtocolManager-Schnittstelle auf. Das Protokoll erstellt ein IWRdsProtocolListener-Objekt und übergibt es zurück an den Remotedesktopdienstedienst.
- Der Remotedesktopdienstedienst ruft StartListen für das IWRdsProtocolListener-Objekt auf.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Windows |
| Kopfzeile | wtsprotocol.h |