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表示 HTTP 模块访问当前全局级别上下文相关信息的main编程接口。 此接口检索编写 HTTP 模块时可以使用的多个附加接口。 例如， GetFileInfo 和 方法分别IHttpFileInfo检索全局上下文的 和 IHttpPerfCounterInfoGetPerfCounterInfo 接口。 这些接口允许开发人员检索特定文件的文件接口或性能计数器的接口。
IIS 7 允许开发人员重启应用程序、重启工作进程，或将当前上下文报告为不正常。 此功能分别通过 RecycleApplication、 RecycleProcess和 ReportUnhealthy 方法公开。
接口 IHttpServer 提供了多种方法，使开发人员能够操作 IIS 缓存。 这些方法是 AddFragmentToCache、、DoCacheOperation、 FlushKernelCacheReadFragmentFromCache和 RemoveFragmentFromCache 方法。
注意
Http.sys管理和拥有片段缓存。 Http.sys可能随时替代或删除您定向存储的信息。 目前无法将片段缓存中的信息锁定为非易失性信息。
开发人员可以使用 GetAppPoolName、 GetManagedType、 GetWorkerProcessSettings和 SatisfiesPrecondition 方法从当前上下文的配置设置中检索信息。
接口 IHttpServer 还提供 NotifyConfigurationChange、 NotifyFileChange、 NotifyCustomNotification 方法，使开发人员能够分别针对配置更改、文件更改或自定义通知条件引发通知。
要求
| 类型 | 说明 |
|---|---|
| 客户端 | - 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 | Httpserv.h |