Интерфейс IHttpServer

Представляет контекст обработки для операций глобального уровня.

Синтаксис

class IHttpServer  

Методы

В следующей таблице перечислены методы, предоставляемые интерфейсом IHttpServer .

Имя	Описание
AddFragmentToCache	Добавляет в кэш структуру HTTP_DATA_CHUNK .
AssociateWithThreadPool	Связывает асинхронную операцию завершения с пулом потоков.
DecrementThreadCount	Уменьшает число потоков для пула потоков.
DispenseContainer	Возвращает контейнер контекста, который может быть размещен.
DoCacheOperation	Выполняет определенную операцию кэша.
FlushKernelCache	Очищает кэш ядра для конкретного универсального кода ресурса (URI).
GetAppPoolName	Извлекает имя пула приложений для текущего запроса.
GetConfigObject	Извлекает объект конфигурации для текущего контекста.
GetFileInfo	Возвращает интерфейс IHttpFileInfo для определенного пути к файлу.
GetManagedType	Извлекает управляемый тип для определенного сайта и универсальный код ресурса (URI).
GetPerfCounterInfo	Извлекает интерфейс IHttpPerfCounterInfo .
GetProtocolManagerCustomInterface	Извлекает пользовательский интерфейс для диспетчера протоколов.
GetTraceContext	Извлекает интерфейс IHttpTraceContext .
GetWorkerProcessSettings	Извлекает интерфейс IWpfSettings .
IncrementThreadCount	Увеличивает число потоков для пула потоков.
IsCommandLineLaunch	Проверяет, был ли рабочий процесс запущен из командной строки.
NotifyConfigurationChange	Активирует уведомление об изменении пути конфигурации.
NotifyCustomNotification	Создает настраиваемое уведомление глобального уровня.
NotifyFileChange	Активирует уведомление об изменении файла.
ReadFragmentFromCache	Извлекает определенный фрагмент из кэша.
RecycleApplication	Перезапускает приложение.
RecycleProcess	Перезапускает рабочий процесс, обрабатывающий текущий запрос.
RegisterFileChangeMonitor	Регистрирует уведомление об изменении файла для определенного каталога.
RemoveFragmentFromCache	Удаляет определенный фрагмент из кэша.
ReportUnhealthy	Сообщает рабочий процесс как неработоспособный.
SatisfiesPrecondition	Определяет, было ли выполнено определенное условие для текущего запроса.

Производные классы

Имя	Описание
IHttpServer2	Представляет контекст обработки для операций глобального уровня и позволяет получать файлы конфигурации, расширенные интерфейсы, метаданные, маркеры и платформу рабочих процессов.

Комментарии

Интерфейс IHttpServer представляет main программный интерфейс для http-модулей для доступа к сведениям о текущем контексте глобального уровня. Этот интерфейс извлекает несколько дополнительных интерфейсов, которые можно использовать при написании http-модулей. Например, методы GetFileInfo и GetPerfCounterInfo извлекают соответственно IHttpFileInfo интерфейсы и IHttpPerfCounterInfo для глобального контекста. Эти интерфейсы позволяют разработчикам получать интерфейс файла для определенного файла или интерфейс для счетчиков производительности.

IIS 7 позволяет разработчикам перезапустить приложение, рабочий процесс или сообщить о текущем контексте как о неработоспособном. Эта функция предоставляется соответственно с помощью RecycleApplicationметодов , RecycleProcessи ReportUnhealthy .

Интерфейс IHttpServer предоставляет несколько методов, позволяющих разработчикам управлять кэшем IIS. Это методы AddFragmentToCache, DoCacheOperation, FlushKernelCache, ReadFragmentFromCacheи RemoveFragmentFromCache .

Примечание

Http.sys управляет кэшем фрагментов и владеет им. В любое время Http.sys может переопределить или удалить информацию, которую вы направили для хранения. В настоящее время невозможно заблокировать сведения в кэше фрагментов как неизменяемые сведения.

Разработчики могут использовать GetAppPoolNameметоды , GetManagedType, GetWorkerProcessSettingsи SatisfiesPrecondition для получения сведений из параметров конфигурации для текущего контекста.

Интерфейс IHttpServer также предоставляет NotifyConfigurationChangeметоды , NotifyFileChange, NotifyCustomNotification которые позволяют разработчикам создавать уведомления об изменениях конфигурации, изменениях файлов или пользовательском условии уведомления соответственно.

Требования

Тип	Описание
клиент	— 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
Заголовок	Httpserv.h

См. также:

Основные интерфейсы веб-сервера