PFN_WEB_CORE_ACTIVATE (Función)

Inicia una instancia del núcleo web hospedado.

Sintaxis

typedef HRESULT (*PFN_WEB_CORE_ACTIVATE)(  
   IN PCWSTR pszAppHostConfigFile,  
   IN PCWSTR pszRootWebConfigFile,  
   IN PCWSTR pszInstanceName  
);  

Parámetros

pszAppHostConfigFile
Puntero a una cadena que contiene la ruta de acceso de un archivo de configuración.

pszRootWebConfigFile
Puntero a una cadena que contiene la ruta de acceso de un archivo de Web.config raíz. (Opcional)

pszInstanceName
Puntero a una cadena que contiene el nombre de la instancia que se usará para el registro de eventos.

Valor devuelto

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

Valor	Descripción
S_OK	Indica que la operación se realizó correctamente.
ERROR_SERVICE_ALREADY_RUNNING	Indica que una instancia del núcleo web hospedado ya se está ejecutando en el proceso.
ERROR_INVALID_DATA	Indica que se produjo un error de configuración en el archivo de configuración.

Nota

Si la PFN_WEB_CORE_ACTIVATE función devuelve un mensaje de ERROR_INVALID_DATA, el Visor de eventos puede contener detalles adicionales sobre la causa del error.

Comentarios

La PFN_WEB_CORE_ACTIVATE función es un prototipo para el WebCoreActivate punto de entrada dll en Hwebcore.dll que se usa para iniciar el núcleo web hospedado. El proceso que hospeda el núcleo web es necesario para proporcionar la ruta de acceso de un archivo de configuración que contiene los valores de configuración de cualquier sitio, el grupo de aplicaciones, etc., que se van a crear.

Nota

Hosted Web Core requiere un archivo de configuración que siga el diseño del archivo ApplicationHost.config, salvo que Hosted Web Core solo admite un grupo de aplicaciones. Para obtener más información sobre cómo crear un archivo de configuración para la aplicación, vea Walkthrough: Creating a Configuration File for Hosted Web Core.

Esta función también requiere el nombre de la instancia de Hosted Web Core que IIS 7 usa cuando registra eventos en el Visor de eventos. Opcionalmente, el proceso de hospedaje puede proporcionar la ruta de acceso de un archivo de Web.config raíz que contiene parámetros adicionales.

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	Hwebcore.h

Consulte también

Referencia de API de Núcleo web hospedado
PFN_WEB_CORE_SHUTDOWN (Función)