IHttpServer インターフェイス
グローバル レベルの操作の処理コンテキストを表します。
構文
class IHttpServer
メソッド
次の表に、 インターフェイスによって公開されるメソッドの一覧を IHttpServer
示します。
名前 | 説明 |
---|---|
AddFragmentToCache | キャッシュに HTTP_DATA_CHUNK 構造体を追加します。 |
AssociateWithThreadPool | 非同期完了操作をスレッド プールに関連付けます。 |
DecrementThreadCount | スレッド プールのスレッド数をデクリメントします。 |
DispenseContainer | 分配される可能性があるコンテキスト コンテナーを返します。 |
DoCacheOperation | 特定のキャッシュ操作を実行します。 |
FlushKernelCache | 特定の Uniform Resource Identifier (URI) のカーネル キャッシュをフラッシュします。 |
GetAppPoolName | 現在の要求のアプリケーション プールの名前を取得します。 |
GetConfigObject | 現在のコンテキストの構成オブジェクトを取得します。 |
GetFileInfo | 特定のファイル パスの IHttpFileInfo インターフェイスを返します。 |
GetManagedType | 特定のサイトのマネージド型と Uniform Resource Identifier (URI) を取得します。 |
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 を使用すると、開発者はアプリケーションを再起動したり、ワーカー プロセスを再起動したり、現在のコンテキストを異常として報告したりできます。 この機能は、それぞれ、、、および ReportUnhealthy
メソッドをRecycleApplication
RecycleProcess
介して公開されます。
インターフェイスには IHttpServer
、開発者が IIS キャッシュを操作できるいくつかのメソッドが用意されています。 これらのメソッドは、AddFragmentToCache
ReadFragmentFromCache
DoCacheOperation
FlushKernelCache
、および RemoveFragmentFromCache
の各メソッドです。
注意
Http.sysはフラグメント キャッシュを管理および所有します。 Http.sysは、保存するように指示した情報をいつでもオーバーライドまたは削除できます。 現在、フラグメント キャッシュ内の情報を不揮発性情報としてロックする方法はありません。
開発者は、、GetManagedType
、GetWorkerProcessSettings
、および SatisfiesPrecondition
メソッドをGetAppPoolName
使用して、現在のコンテキストの構成設定から情報を取得できます。
インターフェイスにはIHttpServer
、 メソッドも用意NotifyFileChange
NotifyConfigurationChange
NotifyCustomNotification
されています。これにより、開発者はそれぞれ、構成の変更、ファイルの変更、またはカスタム通知条件に関する通知を生成できます。
要件
Type | 説明 |
---|---|
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 |
Header | Httpserv.h |