Funzione PFN_WEB_CORE_ACTIVATE

Avvia un'istanza del core Web ospitato.

Sintassi

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

Parametri

pszAppHostConfigFile
Puntatore a una stringa contenente il percorso di un file di configurazione.

pszRootWebConfigFile
Puntatore a una stringa che contiene il percorso di un file radice Web.config. Facoltativa

pszInstanceName
Puntatore a una stringa contenente il nome dell'istanza che verrà usata per la registrazione degli eventi.

Valore restituito

Oggetto HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Valore	Descrizione
S_OK	Indica che l'operazione è riuscita.
ERROR_SERVICE_ALREADY_RUNNING	Indica che un'istanza del core Web ospitato è già in esecuzione nel processo.
ERROR_INVALID_DATA	Indica che si è verificato un errore di configurazione nel file di configurazione.

Nota

Se la PFN_WEB_CORE_ACTIVATE funzione restituisce un messaggio di ERROR_INVALID_DATA, il Visualizzatore eventi può contenere dettagli aggiuntivi relativi alla causa dell'errore.

Commenti

La PFN_WEB_CORE_ACTIVATE funzione è un prototipo per il WebCoreActivate punto di ingresso dll in Hwebcore.dll che viene usato per avviare hosted Web Core. Il processo che ospita il core Web è necessario per fornire il percorso di un file di configurazione che contiene le impostazioni di configurazione per tutti i siti, il pool di applicazioni e così via, che devono essere creati.

Nota

Il core Web ospitato richiede un file di configurazione che segue la progettazione del file ApplicationHost.config, ad eccezione del fatto che Hosted Web Core supporta un solo pool di applicazioni. Per altre informazioni su come creare un file di configurazione per l'applicazione, vedere Procedura dettagliata: Creazione di un file di configurazione per web core ospitato.

Questa funzione richiede anche il nome dell'istanza di Hosted Web Core usata da IIS 7 quando registra gli eventi nel Visualizzatore eventi. Il processo di hosting può facoltativamente fornire il percorso di un file radice Web.config che contiene eventuali parametri aggiuntivi.

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- 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
Intestazione	Hwebcore.h

Vedere anche

Informazioni di riferimento sulle API Web Core ospitate
Funzione PFN_WEB_CORE_SHUTDOWN