IWTSProtocolManager::CreateListener-Methode (wtsprotocol.h)
[IWTSProtocolManager::CreateListener ist ab Windows Server 2012 nicht mehr verfügbar. Verwenden Sie stattdessen IWRdsProtocolManager::CreateListener.]
Fordert die Erstellung eines IWTSProtocolListener-Objekts an, das auf eingehende Clientverbindungsanforderungen lauscht. Der Protokollanbieter muss vor der Rückgabe einen Verweis auf das IWTSProtocolListener-Objekt hinzufügen. Der Remotedesktopdienstedienst gibt den Verweis frei, wenn der Dienst beendet oder das Listenerobjekt gelöscht wird.
Syntax
HRESULT CreateListener(
[in] WCHAR *wszListenerName,
[out] IWTSProtocolListener **pProtocolListener
);
Parameter
[in] wszListenerName
Ein Zeiger auf eine Zeichenfolge, die die Registrierungs-GUID enthält, die den zu erstellenden Listener angibt.
[out] pProtocolListener
Die Adresse eines Zeigers auf das IWTSProtocolListener-Objekt .
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 CreateListener-Methode ist der erste Aufruf, den der Remotedesktopdienstedienst an Ihren Protokollanbieter sendet. Der Dienst sucht in der Registrierung unter dem folgenden Schlüssel nach der GUID des zu erstellenden Listeners:
HKEY_LOCAL_MACHINE System CurrentControlSet Control Terminal Server WinStations ListenerName LoadableProtocol_Object
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 |
| Zielplattform | Windows |
| Kopfzeile | wtsprotocol.h |