Поделиться через

Функция 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