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

Weitere Informationen

IWTSProtocolManager