Partager via


Fonction WebhostCloseAllListenerChannelInstances

Demande à toutes les instances de ce canal d’écouteur de s’arrêter.

Syntaxe

HRESULT WebhostCloseAllListenerChannelInstances(  
   IN DWORD ProtocolHandle,  
   IN LPCWSTR AppPoolId,  
   IN DWORD ListenerChannelId  
);  

Paramètres

ProtocolHandle
[IN] DWORD qui contient le handle de protocole qui représente le protocole pour ce canal d’écouteur.

AppPoolId
[IN] Chaîne qui contient l’ID du pool d’applications pour ce canal d’écouteur.

ListenerChannelId
[IN] DWORD qui contient l’ID de canal de l’écouteur que l’adaptateur de l’écouteur a demandé à arrêter.

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur Description
S_OK Indique que l’opération a réussi.
E_INVALIDARG Indique que l’un des paramètres n’est pas valide.
HRESULT_FROM_WIN32( ERROR_NOT_FOUND) Indique que le protocole n’a pas été inscrit.
HRESULT_FROM_WIN32(ERROR_PIPE_NOT_CONNECTED) Indique que l’adaptateur de l’écouteur n’est pas connecté au service d’activation de processus Windows.

Remarques

L’appel de cette fonction sans canal d’écouteur en cours d’exécution ne retourne pas de code d’erreur.

Cette fonction est appelée dans les conditions suivantes :

  • Le service d’adaptateur d’écouteur s’arrête.

  • L’adaptateur d’écouteur est acheminé par application et l’application est en cours de suppression.

  • Le pool d’applications est en cours de suppression.

  • L’adaptateur d’écouteur est routage par application, et l’application se déplace vers un autre pool d’applications.

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sur Windows 8
- IIS 10.0 sur Windows 10
Serveur - IIS 7.0 sur Windows Server 2008
- IIS 7.5 sur Windows Server 2008 R2
- IIS 8.0 sur Windows Server 2012
- IIS 8.5 sur Windows Server 2012 R2
- IIS 10.0 sur Windows Server 2016
Produit - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
- IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
En-tête Listeneradapter.h

Voir aussi

Fonctions exportées de l’adaptateur d’écouteur
fonction PFN_WEBHOST_LISTENER_APPLICATION_POOL_ALL_LISTENER_CHANNEL_INSTANCES_STOPPED