fonction PFN_WEB_CORE_ACTIVATE

Démarre une instance du cœur web hébergé.

Syntaxe

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

Paramètres

pszAppHostConfigFile
Pointeur vers une chaîne qui contient le chemin d’accès d’un fichier de configuration.

pszRootWebConfigFile
Pointeur vers une chaîne qui contient le chemin d’accès d’un fichier Web.config racine. (facultatif)

pszInstanceName
Pointeur vers une chaîne qui contient le nom du instance qui sera utilisé pour la journalisation des événements.

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.
ERROR_SERVICE_ALREADY_RUNNING	Indique qu’une instance du cœur web hébergé est déjà en cours d’exécution dans le processus.
ERROR_INVALID_DATA	Indique qu’une erreur de configuration s’est produite dans le fichier de configuration.

Notes

Si la PFN_WEB_CORE_ACTIVATE fonction retourne un message ERROR_INVALID_DATA, le observateur d'événements peut contenir des détails supplémentaires sur la cause de l’échec.

Remarques

La PFN_WEB_CORE_ACTIVATE fonction est un prototype pour le WebCoreActivate point d’entrée DLL dans Hwebcore.dll qui est utilisé pour démarrer le cœur web hébergé. Le processus qui héberge le cœur web est requis pour fournir le chemin d’accès d’un fichier de configuration qui contient les paramètres de configuration pour tous les sites, le pool d’applications, etc., qui doivent être créés.

Notes

Le cœur web hébergé nécessite un fichier de configuration qui suit la conception du fichier ApplicationHost.config, sauf que le cœur web hébergé ne prend en charge qu’un seul pool d’applications. Pour plus d’informations sur la création d’un fichier de configuration pour votre application, consultez Procédure pas à pas : création d’un fichier de configuration pour le web principal hébergé.

Cette fonction nécessite également le nom du instance du cœur web hébergé utilisé par IIS 7 lorsqu’il journalise des événements dans le observateur d'événements. Le processus d’hébergement peut éventuellement fournir le chemin d’accès d’un fichier Web.config racine qui contient des paramètres supplémentaires.

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

Voir aussi

Informations de référence sur l’API Web Core hébergée
fonction PFN_WEB_CORE_SHUTDOWN