PFN_WEB_CORE_ACTIVATE-Funktion

Artikel
07/19/2023

Startet eine instance des gehosteten Web Core.

Syntax

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

Parameter

pszAppHostConfigFile
Ein Zeiger auf eine Zeichenfolge, die den Pfad einer Konfigurationsdatei enthält.

pszRootWebConfigFile
Ein Zeiger auf eine Zeichenfolge, die den Pfad einer Stammdatei Web.config enthält. (Optional)

pszInstanceName
Ein Zeiger auf eine Zeichenfolge, die den Namen der instance enthält, die für die Ereignisprotokollierung verwendet wird.

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert	BESCHREIBUNG
S_OK	Gibt an, dass der Vorgang erfolgreich war.
ERROR_SERVICE_ALREADY_RUNNING	Gibt an, dass im Prozess bereits eine instance des gehosteten Web Core ausgeführt wird.
ERROR_INVALID_DATA	Gibt an, dass in der Konfigurationsdatei ein Konfigurationsfehler aufgetreten ist.

Hinweis

Wenn die PFN_WEB_CORE_ACTIVATE Funktion eine ERROR_INVALID_DATA Meldung zurückgibt, kann die Ereignisanzeige zusätzliche Details zur Ursache des Fehlers enthalten.

Bemerkungen

Die PFN_WEB_CORE_ACTIVATE Funktion ist ein Prototyp für den WebCoreActivate DLL-Einstiegspunkt in Hwebcore.dll, der zum Starten des gehosteten Web Core verwendet wird. Der Prozess, der den Webkern hostet, ist erforderlich, um den Pfad einer Konfigurationsdatei bereitzustellen, die die Konfigurationseinstellungen für alle Standorte, den Anwendungspool usw. enthält, die erstellt werden sollen.

Hinweis

Der gehostete Web Core erfordert eine Konfigurationsdatei, die dem Entwurf der ApplicationHost.config-Datei folgt, mit der Ausnahme, dass Hosted Web Core nur einen Anwendungspool unterstützt. Weitere Informationen zum Erstellen einer Konfigurationsdatei für Ihre Anwendung finden Sie unter Exemplarische Vorgehensweise: Erstellen einer Konfigurationsdatei für gehostetes Web Core.

Diese Funktion erfordert auch den Namen des instance des gehosteten Web Cores, den IIS 7 verwendet, wenn Ereignisse im Ereignisanzeige protokolliert werden. Der Hostingprozess kann optional den Pfad einer Stammdatei Web.config bereitstellen, die zusätzliche Parameter enthält.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 auf Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 auf Windows Server 2016
Produkt	– 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
Header	Hwebcore.h

Weitere Informationen

Referenz zur gehosteten Web Core-API
PFN_WEB_CORE_SHUTDOWN-Funktion

Freigeben über