Función WebhostOpenListenerChannelInstance

Solicita que se inicie un canal de escucha en un proceso de trabajo para este grupo de aplicaciones.

Sintaxis

HRESULT WebhostOpenListenerChannelInstance(  
   IN DWORD ProtocolHandle,  
   IN LPCWSTR AppPoolId,  
   IN DWORD ListenerChannelId,  
   IN PBYTE ListenerChannelBlob,  
   IN DWORD ListenerChannelBlobByteCount  
);  

Parámetros

ProtocolHandle
[IN] que DWORD contiene el identificador de protocolo para el canal del agente de escucha.

AppPoolId
[IN] Cadena que contiene el identificador del grupo de aplicaciones para el canal de escucha.

ListenerChannelId
[IN] que DWORD contiene el identificador del canal del agente de escucha.

ListenerChannelBlob
[IN] que PBYTE contiene información necesaria para conectar el proceso de trabajo al agente de escucha. Los datos no son visibles para el servicio de activación de procesos de Windows (WAS). Para obtener más información, vea la sección Comentarios a continuación.

ListenerChannelBlobByteCount
[IN] que DWORD contiene el número de bytes en el blob del canal de escucha.

Valor devuelto

Una clase HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Value	Descripción
S_OK	Indica que la operación se realizó correctamente.
E_INVALIDARG	Indica que uno de los parámetros no es válido.
HRESULT_FROM_WIN32( ERROR_NOT_FOUND)	Indica que el protocolo no se ha registrado.
HRESULT_FROM_WIN32(ERROR_PIPE_NOT_CONNECTED)	Indica que el adaptador del agente de escucha no está conectado al servicio de activación de procesos de Windows.

Comentarios

Se llama a la función cuando el canal de escucha recibe su primera solicitud o cuando el servicio de activación de procesos de Windows notifica al adaptador del agente de escucha que puede iniciar otra instancia del canal del agente de escucha.

El ListenerChannelBlob parámetro se pasa al servicio de activación de procesos de Windows, al proceso de trabajo y al administrador de protocolos. Si el adaptador del agente de escucha está enrutando solicitudes por aplicación, es probable que el BLOB contenga la clave de aplicación que el controlador de protocolo de proceso tendrá que pasar al administrador de protocolos. El administrador de protocolos necesita que la clave de aplicación del controlador de protocolo de dominio de aplicación esté conectada. Los detalles del BLOB se dejan al escritor de protocolos.

De forma predeterminada, el servicio de activación de procesos de Windows establece un proceso de reciclaje superpuesto, en el que el proceso de trabajo que se va a apagar se sigue ejecutando hasta que se inicia un nuevo proceso de trabajo. El servicio de activación de procesos de Windows guarda el blob del canal de escucha y lo usará para pedir al nuevo proceso de trabajo que se conecte. Esto significa que el canal del agente de escucha debe ser capaz de aceptar varios procesos que se conectan a él.

El servicio de activación de procesos de Windows no administra cómo se relaciona un canal de agente de escucha con una aplicación (por ejemplo, el agente de escucha puede elegir tener muchos canales de escucha por grupo de aplicaciones o solo uno). Por lo tanto, el servicio de activación de procesos de Windows no puede determinar para el adaptador del agente de escucha lo que debe ocurrir con los canales de escucha cuando se producen cambios. El servicio de activación de procesos de Windows simplemente notificará al adaptador del agente de escucha y le permitirá administrar esas decisiones.

Deberá establecer las listas de control de acceso (ACL) de los canales de escucha en la identidad del grupo de aplicaciones.

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Servidor	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- 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
Encabezado	Listeneradapter.h

Consulte también

Funciones exportadas del adaptador de escucha