Функция PFN_WEB_CORE_ACTIVATE
Запускает экземпляр размещенного веб-ядра.
Синтаксис
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 | Указывает, что экземпляр размещенного веб-ядра уже запущен в процессе. |
ERROR_INVALID_DATA | Указывает, что в файле конфигурации произошла ошибка. |
Примечание
PFN_WEB_CORE_ACTIVATE
Если функция возвращает сообщение ERROR_INVALID_DATA, Просмотр событий может содержать дополнительные сведения о причине сбоя.
Комментарии
Функция PFN_WEB_CORE_ACTIVATE
является прототипом точки WebCoreActivate
входа DLL в Hwebcore.dll, которая используется для запуска размещенного веб-ядра. Процесс, в котором размещается веб-ядро, требуется для предоставления пути к файлу конфигурации, который содержит параметры конфигурации для всех создаваемых сайтов, пула приложений и т. д.
Примечание
Для hosted Web Core требуется файл конфигурации, соответствующий структуре файла ApplicationHost.config, за исключением того, что hosted Web Core поддерживает только один пул приложений. Дополнительные сведения о создании файла конфигурации для приложения см. в разделе Пошаговое руководство. Создание файла конфигурации для размещенного веб-ядра.
Для этой функции также требуется имя экземпляра размещенного веб-ядра, которое iis 7 использует при регистрации событий в Просмотр событий. При необходимости процесс размещения может предоставить путь к корневому Web.config файлу, содержащему дополнительные параметры.
Требования
Тип | Описание |
---|---|
клиент | — IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10 |
Сервер | — IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016 |
Продукт | — 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 |
См. также:
Справочник по API hosted Web Core
Функция PFN_WEB_CORE_SHUTDOWN