Интерфейс 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 |