Méthode IWTSProtocolListener ::StartListen (wtsprotocol.h)
[IWTSProtocolListener ::StartListen n’est plus disponible depuis Windows Server 2012. Utilisez plutôt IWRdsProtocolListener ::StartListen.]
Avertit le protocole de commencer à écouter les demandes de connexion du client.
Syntaxe
HRESULT StartListen(
[in] IWTSProtocolListenerCallback *pCallback
);
Paramètres
[in] pCallback
Pointeur vers un objet IWTSProtocolListenerCallback implémenté par le service Services Bureau à distance. Le protocole utilise l’objet IWTSProtocolListenerCallback pour notifier le
Service Services Bureau à distance sur les demandes de connexion entrantes. Le protocole doit ajouter une référence à cet objet et le libérer lorsque StopListen est appelé.
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 StartListen est appelée au démarrage du service Services Bureau à distance.
- Le service Services Bureau à distance appelle CoCreateInstance pour créer un objet IWTSProtocolManager .
- Le service Services Bureau à distance appelle CreateListener sur l’interface IWTSProtocolManager . Le protocole crée un objet IWTSProtocolListener et le transmet au service Services Bureau à distance.
- Le service Services Bureau à distance appelle StartListen sur l’objet IWTSProtocolListener .
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 |