Función WebhostRegisterProtocol

Declara el protocolo que admite el adaptador del agente de escucha.

Sintaxis

HRESULT WebhostRegisterProtocol(  
   IN LPCWSTR ProtocolId,  
   IN VOID* pListenerCallbacks,  
   IN VOID* pContext,  
   OUT DWORD* pProtocolHandle  
);  

Parámetros

ProtocolId
[IN] Cadena que contiene el protocolo que admite este adaptador de agente de escucha.

pListenerCallbacks
[IN] Puntero VOID a la estructura WEBHOST_LISTENER_CALLBACKS .

pContext
[IN] Puntero arbitrario VOID que pasará el adaptador del agente de escucha.

pProtocolHandle
[OUT] Puntero a un DWORD objeto que contiene la clave única del proceso que representa este protocolo.

Valor devuelto

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

Comentarios

Primero debe llamar a la WebhostRegisterProtocol función al iniciar un adaptador de agente de escucha. WebhostRegisterProtocol es asincrónico, por lo que una devolución correcta no garantiza que la llamada se haya realizado correctamente. El Servicio de activación de procesos de Windows (WAS) notifica al agente de escucha que se ha registrado correctamente mediante la función PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED . PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED se pasa el pListenerCallbacks parámetro a esta llamada.

Debe establecer un tiempo de espera para que el adaptador del agente de escucha espere a la PFN_WEBHOST_LISTENER_CONFIG_MANAGER_CONNECTED función de devolución de llamada. Si expira el tiempo de espera, debe detener el servicio del adaptador del agente de escucha y marcarlo como erróneo. Una devolución correcta de esta llamada indica que la biblioteca cliente está esperando el servicio de activación de procesos de Windows y se conectará cuando sea posible.

No debe establecer el estado del servicio de escucha en SERVICE_RUNNING de esta función de devolución de llamada. Debe establecer el estado del servicio en SERVICE_RUNNING solo cuando se complete la inicialización y el agente de escucha de protocolo esté escuchando (normalmente después de la notificación de PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED ).

El pContext parámetro se pasa al adaptador del agente de escucha cada vez que se invoca una función de devolución de llamada. Se puede usar cuando se implementan varios protocolos que usan la misma estructura de devolución de llamada.

Para que la biblioteca cliente se conecte al servicio de activación de procesos de Windows, se deben cumplir las condiciones siguientes:

• La <listenerAdapters> sección de configuración del archivo Was.config debe declarar el protocolo y la identidad en la que se ejecutarán los adaptadores del agente de escucha.

• El servicio de activación de procesos de Windows debe estar en ejecución.

• Los servicios del adaptador del agente de escucha deben registrarse como dependientes del servicio de activación de procesos de Windows.

Requisitos

Consulte también

PFN_WEBHOST_LISTENER_CONFIG_MANAGER_INITIALIZATION_COMPLETED (Función)
Funciones exportadas del adaptador de escucha