通过

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;

parameters

dwOldChangeNumber
[IN]一个 DWORD 包含旧更改号的 。

pdwNewChangeNumber
[OUT]指向包含新更改编号的 的指针 DWORD 。

knownHeaderSnapshot
[IN][OUT]指向包含所有已知标头快照的字符串数组的指针。 (调用时数组将包含新标头，并在 returning 时包含旧标头。)

pdwUnknownHeaderSnapShot
[IN][OUT]指向 的DWORD指针，其中包含快照中未知标头的数目。

ppUnknownHeaderNameSnapShot
[IN][OUT]指向包含所有未知标头名称的字符串数组地址的指针。 (调用时数组将包含新标头，并在 returning 时包含旧标头。)

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 方法。

要求

类型 说明
客户端 - 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 方法