IHttpServer 介面
表示全域層級作業的處理內容。
Syntax
class IHttpServer
方法
下表列出 介面所 IHttpServer 公開的方法。
| 名稱 | 描述 |
|---|---|
| AddFragmentToCache | 將 HTTP_DATA_CHUNK 結構新增至快取。 |
| AssociateWithThreadPool | 建立異步完成作業與執行緒集區的關聯。 |
| DecrementThreadCount | 遞減執行緒集區的執行緒計數。 |
| DispenseContainer | 傳回可能已分配的內容容器。 |
| DoCacheOperation | 執行特定的快取作業。 |
| FlushKernelCache | 排清特定統一資源識別項 (URI) 的核心快取。 |
| GetAppPoolName | 擷取目前要求的應用程式集區名稱。 |
| GetConfigObject | 擷取目前內容的組態物件。 |
| GetFileInfo | 傳回特定檔案路徑的 IHttpFileInfo 介面。 |
| GetManagedType | 擷取特定網站和統一資源識別項 (URI) 的 Managed 類型。 |
| GetPerfCounterInfo | 擷取 IHttpPerfCounterInfo 介面。 |
| GetProtocolManagerCustomInterface | 擷取通訊協定管理員的自訂介面。 |
| GetTraceCoNtext | 擷取 IHttpTraceCoNtext 介面。 |
| GetWorkerProcessSettings | 擷取 IWpfSettings 介面。 |
| IncrementThreadCount | 遞增執行緒集區的執行緒計數。 |
| IsCommandLineLaunch | 測試背景工作進程是否已從命令列啟動。 |
| NotifyConfigurationChange | 觸發設定路徑已變更的通知。 |
| NotifyCustomNotification | 引發自訂全域層級通知。 |
| NotifyFileChange | 觸發檔案已變更的通知。 |
| ReadFragmentFromCache | 從快取擷取特定片段。 |
| RecycleApplication | 回收應用程式。 |
| RecycleProcess | 回收正在處理目前要求的背景工作進程。 |
| RegisterFileChangeMonitor | 註冊特定目錄的檔案變更通知。 |
| RemoveFragmentFromCache | 從快取中移除特定片段。 |
| ReportUnhealthy | 將背景工作進程報告為狀況不良。 |
| SatisfiesPrecondition | 判斷是否已符合目前要求的特定前置條件。 |
衍生類別
| 名稱 | 描述 |
|---|---|
| IHttpServer2 | 表示全域層級作業的處理內容，並啟用擷取組態檔、擴充介面、中繼資料、權杖和背景工作進程架構。 |
備註
介面 IHttpServer 代表 HTTP 模組的主要程式設計介面，可存取目前全域層級內容的相關資訊。 此介面會擷取數個可在撰寫 HTTP 模組時使用的其他介面。 例如， GetFileInfo 和 GetPerfCounterInfo 方法會分別 IHttpFileInfo 擷取全域內容的 和 IHttpPerfCounterInfo 介面。 這些介面可讓開發人員擷取特定檔案的檔案介面，或效能計數器的介面。
IIS 7 可讓開發人員重新開機應用程式、重新開機背景工作進程，或將目前的內容回報為狀況不良。 這項功能會透過 RecycleApplication 、 RecycleProcess 和 ReportUnhealthy 方法分別公開。
介面 IHttpServer 提供數種方法，可讓開發人員操作 IIS 快取。 這些方法是 AddFragmentToCache 、 DoCacheOperation 、 FlushKernelCacheReadFragmentFromCache 、 和 RemoveFragmentFromCache 方法。
注意
Http.sys管理並擁有片段快取。 您可以隨時Http.sys覆寫或刪除您導向儲存的資訊。 目前沒有任何方法會將片段快取中的資訊鎖定為非volatiatile 資訊。
開發人員可以使用 GetAppPoolName 、 GetManagedType 、 GetWorkerProcessSettings 和 SatisfiesPrecondition 方法，從目前內容的組態設定中擷取資訊。
介面 IHttpServer 也提供 NotifyConfigurationChange 、 NotifyFileChangeNotifyCustomNotification 方法，可讓開發人員分別針對組態變更、檔案變更或自訂通知條件引發通知。
規格需求
| 類型 | 描述 |
|---|---|
| Client | - 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 |
| 標頭 | Httpserv.h |