Метод IHttpRequest::GetHeaderChanges

Статья
07/19/2023

Извлекает изменения заголовков сервера для текущего запроса.

Синтаксис

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] Указатель на массив строк, содержащий snapshot всех известных заголовков. (Массив будет содержать новые заголовки при вызове и старые заголовки при возврате.)

pdwUnknownHeaderSnapShot
[IN] [OUT] Указатель на DWORD , содержащий количество неизвестных заголовков в snapshot.

ppUnknownHeaderNameSnapShot
[IN] [OUT] Указатель на адрес массива строк, который содержит имена всех неизвестных заголовков. (Массив будет содержать новые заголовки при вызове и старые заголовки при возврате.)

ppUnknownHeaderValueSnapShot
[IN] [OUT] Указатель на адрес массива строк, который содержит список всех значений заголовков в snapshot.

diffedKnownHeaderIndices
[OUT] Массив значений DWORD , заканчивающийся значением –1, который содержит индексы заголовков, которые были изменены в списке известных заголовков.

pdwDiffedUnknownHeaders
[OUT] Указатель на DWORD значение, содержащее количество измененных неизвестных заголовков.

ppDiffedUnknownHeaderIndices
[OUT] Указатель на адрес массива значений DWORD , заканчивающегося значением –1, который содержит индексы заголовков, измененных в списке неизвестных заголовков.

Возвращаемое значение

Объект HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Значение	Описание:
S_OK	Указывает, что операция выполнена успешно.
ERROR_NOT_ENOUGH_MEMORY	Указывает, что для выполнения операции недостаточно памяти.

Iis использует метод для внутренней GetHeaderChanges синхронизации заголовков между вызовами машинного и управляемого кода. Не следует использовать GetHeaderChanges метод при создании модуля HTTP.

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— 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

См. также:

Интерфейс IHttpRequest
Метод IHttpRequest::GetHeader
Метод IHttpResponse::GetHeader
Метод IHttpResponse::GetHeaderChanges

Поделиться через