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 メソッド