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 使用 方法，在內部同步處理原生和 Managed 程式碼呼叫之間的標頭。 當您建立 HTTP 模組時，不應該使用 GetHeaderChanges 方法。

規格需求

類型	描述
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

另請參閱

IHttpResponse 介面
IHttpResponse：：GetHeader 方法
IHttpRequest：：GetHeader 方法
IHttpRequest：：GetHeaderChanges 方法