Méthode IWTSProtocolManager ::CreateListener (wtsprotocol.h)
[IWTSProtocolManager ::CreateListener n’est plus disponible à partir de Windows Server 2012. Utilisez plutôt IWRdsProtocolManager ::CreateListener.]
Demande la création d’un objet IWTSProtocolListener qui écoute les demandes de connexion client entrantes. Le fournisseur de protocole doit ajouter une référence à l’objet IWTSProtocolListener avant de retourner. Le service Services Bureau à distance libère la référence lorsque le service s’arrête ou que l’objet écouteur est supprimé.
Syntaxe
HRESULT CreateListener(
[in] WCHAR *wszListenerName,
[out] IWTSProtocolListener **pProtocolListener
);
Paramètres
[in] wszListenerName
Pointeur vers une chaîne qui contient le GUID de Registre qui spécifie l’écouteur à créer.
[out] pProtocolListener
Adresse d’un pointeur vers l’objet IWTSProtocolListener .
Valeur retournée
Lorsque vous implémentez cette méthode, retournez S_OK si la fonction réussit. En cas d’échec, retournez une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
La méthode CreateListener est le premier appel que le service Services Bureau à distance effectue dans votre fournisseur de protocole. Le service recherche dans le Registre sous la clé suivante le GUID de l’écouteur à créer :
HKEY_LOCAL_MACHINE System CurrentControlSet Control Terminal Server WinStations ListenerName LoadableProtocol_Object
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| Plateforme cible | Windows |
| En-tête | wtsprotocol.h |