Méthode IWRdsProtocolManager::CreateListener (wtsprotocol.h)
Demande la création d’un objet IWRdsProtocolListener qui écoute les demandes de connexion client entrantes. Le fournisseur de protocole doit ajouter une référence à l’objet IWRdsProtocolListener 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] IWRdsProtocolListener **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 IWRdsProtocolListener .
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
Spécifications
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2012 |
| Plateforme cible | Windows |
| En-tête | wtsprotocol.h |