PFN_WEB_CORE_ACTIVATE 函数
启动托管 Web Core 的实例。
语法
typedef HRESULT (*PFN_WEB_CORE_ACTIVATE)(
IN PCWSTR pszAppHostConfigFile,
IN PCWSTR pszRootWebConfigFile,
IN PCWSTR pszInstanceName
);
parameters
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中用于启动托管 Web Core 的 DLL 入口点的原型 WebCoreActivate 。 承载 Web 核心的进程需要提供包含要创建的任何站点、应用程序池等的配置设置的配置文件的路径。
注意
托管 Web 核心需要遵循 ApplicationHost.config 文件设计的配置文件，但托管 Web 核心仅支持一个应用程序池。 有关如何为应用程序创建配置文件的详细信息，请参阅 演练：为托管 Web 核心创建配置文件。
此函数还需要 IIS 7 在将事件记录到事件查看器时使用的托管 Web 核心实例的名称。 宿主进程可以选择提供包含任何其他参数的根Web.config文件的路径。
要求
| 类型 | 说明 |
|---|---|
| 客户端 | - 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 |