Fonction WebhostOpenListenerChannelInstance
Demande qu’un canal d’écouteur soit démarré dans un processus worker pour ce pool d’applications.
Syntaxe
HRESULT WebhostOpenListenerChannelInstance(
IN DWORD ProtocolHandle,
IN LPCWSTR AppPoolId,
IN DWORD ListenerChannelId,
IN PBYTE ListenerChannelBlob,
IN DWORD ListenerChannelBlobByteCount
);
Paramètres
ProtocolHandle
[IN] DWORD qui contient le handle de protocole pour le canal de l’écouteur.
AppPoolId
[IN] Chaîne qui contient l’ID du pool d’applications pour le canal de l’écouteur.
ListenerChannelId
[IN] qui contient l’identificateur de canal de DWORD l’écouteur.
ListenerChannelBlob
[IN] PBYTE qui contient les informations nécessaires pour connecter le processus de travail à l’écouteur. Les données ne sont pas visibles par le service WAS (Windows Process Activation Service). Pour plus d’informations, consultez la section Remarques ci-dessous.
ListenerChannelBlobByteCount
[IN] DWORD qui contient le nombre d’octets dans l’objet BLOB du canal de l’écouteur.
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
La fonction est appelée lorsque le canal de l’écouteur reçoit sa première demande ou lorsque le service d’activation de processus Windows avertit l’adaptateur de l’écouteur qu’il peut démarrer une autre instance du canal de l’écouteur.
Le ListenerChannelBlob paramètre est passé au service d’activation de processus Windows, au processus worker et au gestionnaire de protocoles. Si l’adaptateur de l’écouteur achemine les demandes par application, l’objet BLOB contiendra probablement la clé d’application que le gestionnaire de protocole de processus doit passer au gestionnaire de protocoles. Le gestionnaire de protocoles a besoin de la clé d’application pour que le gestionnaire de protocole de domaine d’application soit connecté. Les détails de l’objet BLOB sont laissés au rédacteur de protocole.
Par défaut, le service d’activation de processus Windows établit un processus de recyclage qui se chevauche, dans lequel le processus de travail qui doit être arrêté est maintenu en cours d’exécution jusqu’à ce qu’un nouveau processus de travail soit démarré. Le service d’activation de processus Windows enregistre l’objet BLOB du canal de l’écouteur et l’utilise pour demander au nouveau processus de travail de se connecter. Cela signifie que le canal de l’écouteur doit être en mesure d’accepter plusieurs processus qui s’y connectent.
Le service d’activation de processus Windows ne gère pas la façon dont un canal d’écouteur est lié à une application (par exemple, l’écouteur peut choisir d’avoir plusieurs canaux d’écouteurs par pool d’applications ou un seul). Par conséquent, le service d’activation de processus Windows ne peut pas déterminer pour l’adaptateur d’écouteur ce qui doit arriver aux canaux de l’écouteur lorsque des modifications se produisent. Le service d’activation de processus Windows avertit simplement l’adaptateur de l’écouteur et lui permet de gérer ces décisions.
Vous devez définir les listes de contrôle d’accès (ACL) des canaux de l’écouteur sur l’identité du 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 |