IHttpResponse::GetHeaderChanges メソッド

現在の応答のサーバー ヘッダーに対する変更を取得します。

構文

virtual HRESULT GetHeaderChanges(  
   IN DWORD dwOldChangeNumber,  
   OUT DWORD* pdwNewChangeNumber,  
   IN OUT PCSTR knownHeaderSnapshot [HttpHeaderResponseMaximum],  
   IN OUT DWORD* pdwUnknownHeaderSnapShot,  
   IN OUT PCSTR** ppUnknownHeaderNameSnapShot,  
   IN OUT PCSTR** ppUnknownHeaderValueSnapShot,  
   __out_ecount(HttpHeaderResponseMaximum+1) DWORD diffedKnownHeaderIndices [HttpHeaderResponseMaximum+1],  
   OUT DWORD* pdwDiffedUnknownHeaders,  
   OUT DWORD** ppDiffedUnknownHeaderIndices  
) = 0;  

パラメーター

dwOldChangeNumber
[IN] DWORD 古い変更番号を含む 。

pdwNewChangeNumber
[OUT]新しい変更番号を含む への DWORD ポインター。

knownHeaderSnapshot
[IN][OUT]既知のすべてのヘッダーのスナップショットを含む文字列配列へのポインター。 (配列には、 を呼び出すときに新しいヘッダーが含まれます。また、 を返すときには古いヘッダーが含まれます)。

pdwUnknownHeaderSnapShot
[IN][OUT]スナップショット内の不明なヘッダーの数を含む へのポインターDWORD。

ppUnknownHeaderNameSnapShot
[IN][OUT]すべての不明なヘッダーの名前を含む文字列配列のアドレスへのポインター。 (配列には、 を呼び出すときに新しいヘッダーが含まれます。また、 を返すときには古いヘッダーが含まれます)。

ppUnknownHeaderValueSnapShot
[IN][OUT]スナップショット内のすべてのヘッダー値のリストを含む文字列配列のアドレスへのポインター。

diffedKnownHeaderIndices
[OUT]既知のヘッダーの一覧で変更されたヘッダーの DWORD インデックスを含む 、-1 の値で終わる値の配列。

pdwDiffedUnknownHeaders
[OUT]変更された不明なヘッダーの数を含む への DWORD ポインター。

ppDiffedUnknownHeaderIndices
[OUT]不明なヘッダーの一覧で変更されたヘッダーの DWORD インデックスを含む 、-1 の値で終わる値の配列のアドレスへのポインター。

戻り値

HRESULT。 有効な値を次の表に示しますが、これ以外にもあります。

値	説明
S_OK	操作が成功したことを示します。
ERROR_NOT_ENOUGH_MEMORY	操作を実行するのに十分なメモリがないことを示します。

解説

IIS では、 メソッドを GetHeaderChanges 使用して、ヘッダーが最後に検査されてからの HTTP ヘッダーの変更をテストします。

注意

IIS では、 メソッドを GetHeaderChanges 使用して、ネイティブ コードとマネージド コードの呼び出しの間でヘッダーを内部的に同期します。 HTTP モジュールを作成するときは、 GetHeaderChanges メソッドを使用しないでください。

要件

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

参照

IHttpResponse インターフェイス
IHttpResponse::GetHeader メソッド
IHttpRequest::GetHeader メソッド
IHttpRequest::GetHeaderChanges メソッド