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.

1. Der Remotedesktopdienstedienst ruft CoCreateInstance auf, um ein IWTSProtocolManager-Objekt zu erstellen.
2. Der Remotedesktopdienstedienst ruft CreateListener auf der IWTSProtocolManager-Schnittstelle auf. Das Protokoll erstellt ein IWTSProtocolListener-Objekt und übergibt es zurück an den Remotedesktopdienstedienst.
3. Der Remotedesktopdienstedienst ruft StartListen für das IWTSProtocolListener-Objekt auf.

Anforderungen

Weitere Informationen

IWTSProtocolListener