PFN_WEB_CORE_ACTIVATE関数
ホストされている Web Core のインスタンスを開始します。
構文
typedef HRESULT (*PFN_WEB_CORE_ACTIVATE)(
IN PCWSTR pszAppHostConfigFile,
IN PCWSTR pszRootWebConfigFile,
IN PCWSTR pszInstanceName
);
パラメーター
pszAppHostConfigFile
構成ファイルのパスを含む文字列へのポインター。
pszRootWebConfigFile
ルート Web.config ファイルのパスを含む文字列へのポインター。 (省略可能)
pszInstanceName
イベント ログに使用されるインスタンスの名前を含む文字列へのポインター。
戻り値
HRESULT。 有効な値を次の表に示しますが、これ以外にもあります。
| 値 | 説明 |
|---|---|
| S_OK | 操作が成功したことを示します。 |
| ERROR_SERVICE_ALREADY_RUNNING | Hosted Web Core のインスタンスがプロセスで既に実行されていることを示します。 |
| ERROR_INVALID_DATA | 構成ファイルで構成エラーが発生したことを示します。 |
注意
関数がPFN_WEB_CORE_ACTIVATEERROR_INVALID_DATA メッセージを返す場合、エラーの原因に関する追加の詳細がイベント ビューアーに含まれている可能性があります。
解説
関数は PFN_WEB_CORE_ACTIVATE 、Hwebcore.dllの WebCoreActivate DLL エントリ ポイントのプロトタイプであり、ホステッド Web コアを開始するために使用されます。 Web コアをホストするプロセスは、作成するサイト、アプリケーション プールなどの構成設定を含む構成ファイルのパスを指定する必要があります。
注意
Hosted Web Core には、ApplicationHost.config ファイルの設計に従った構成ファイルが必要です。ただし、Hosted Web Core でサポートされるアプリケーション プールは 1 つだけです。 アプリケーションの構成ファイルを作成する方法の詳細については、「 チュートリアル: ホスト型 Web Core 用の構成ファイルの作成」を参照してください。
この関数には、IIS 7 がイベントをイベント ビューアーにログに記録するときに使用する Hosted Web Core のインスタンスの名前も必要です。 ホスティング プロセスでは、必要に応じて、追加のパラメーターを含むルート Web.config ファイルのパスを指定できます。
要件
| Type | 説明 |
|---|---|
| Client | - Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10の IIS 10.0 |
| サーバー | - Windows Server 2008 の IIS 7.0 - Windows Server 2008 R2 の IIS 7.5 - Windows Server 2012 の IIS 8.0 - Windows Server 2012 R2 の IIS 8.5 - Windows Server 2016の IIS 10.0 |
| 製品 | - 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 |