PFN_WEB_CORE_ACTI加值稅E函式
啟動託管 Web 核心的實例。
語法
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 | 表示裝載 Web 核心的實例已在進程中執行。 |
| ERROR_INVALID_DATA | 表示組態檔中發生組態錯誤。 |
注意
如果函 PFN_WEB_CORE_ACTIVATE 式傳回ERROR_INVALID_DATA訊息，事件檢視器可能包含有關失敗原因的其他詳細資料。
備註
函 PFN_WEB_CORE_ACTIVATE 式是 Hwebcore.dll 中 DLL 進入點的 WebCoreActivate 原型，可用來啟動託管 Web 核心。 裝載 Web 核心的程式必須提供組態檔的路徑，其中包含要建立的任何月臺、應用程式集區等等的組態設定。
注意
託管 Web Core 需要遵循ApplicationHost.config檔案設計的組態檔，但裝載的 Web Core 僅支援一個應用程式集區。 如需如何為應用程式建立組態檔的詳細資訊，請參閱逐步解說 ：建立託管 Web 核心的組態檔。
此函式也需要 IIS 7 在將事件記錄至事件檢視器時所使用的託管 Web Core 實例名稱。 裝載進程可以選擇性地提供根Web.config檔案的路徑，其中包含任何其他參數。
規格需求
| 類型 | 描述 |
|---|---|
| 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 |
| 標頭 | Hwebcore.h |