IHttpRequest::GetHeaderChanges メソッド

現在の要求のサーバー ヘッダーへの変更を取得します。

構文

virtual HRESULT GetHeaderChanges(  
   IN DWORD dwOldChangeNumber,  
   OUT DWORD* pdwNewChangeNumber,  
   IN OUT PCSTR knownHeaderSnapshot [HttpHeaderRequestMaximum],  
   IN OUT DWORD* pdwUnknownHeaderSnapShot,  
   IN OUT PCSTR** ppUnknownHeaderNameSnapShot,  
   IN OUT PCSTR** ppUnknownHeaderValueSnapShot,  
   __out_ecount(HttpHeaderRequestMaximum+1) DWORD diffedKnownHeaderIndices [HttpHeaderRequestMaximum+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

参照

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