Compartilhar via


Método IHttpResponse::GetHeaderChanges

Recupera as alterações nos cabeçalhos do servidor para a resposta atual.

Sintaxe

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;  

Parâmetros

dwOldChangeNumber
[IN] Um DWORD que contém o número de alteração antigo.

pdwNewChangeNumber
[OUT] Um ponteiro para um DWORD que contém o novo número de alteração.

knownHeaderSnapshot
[IN] [OUT] Um ponteiro para uma matriz de cadeia de caracteres que contém o instantâneo de todos os cabeçalhos conhecidos. (A matriz conterá os novos cabeçalhos ao chamar e conterá os cabeçalhos antigos ao retornar.)

pdwUnknownHeaderSnapShot
[IN] [OUT] Um ponteiro para um DWORD que contém o número de cabeçalhos desconhecidos no instantâneo.

ppUnknownHeaderNameSnapShot
[IN] [OUT] Um ponteiro para o endereço de uma matriz de cadeia de caracteres que contém os nomes de todos os cabeçalhos desconhecidos. (A matriz conterá os novos cabeçalhos ao chamar e conterá os cabeçalhos antigos ao retornar.)

ppUnknownHeaderValueSnapShot
[IN] [OUT] Um ponteiro para o endereço de uma matriz de cadeia de caracteres que contém uma lista de todos os valores de cabeçalho no instantâneo.

diffedKnownHeaderIndices
[OUT] Uma matriz de DWORD valores, terminada por um valor –1, que contém os índices de cabeçalhos que foram alterados na lista de cabeçalhos conhecidos.

pdwDiffedUnknownHeaders
[OUT] Um ponteiro para um DWORD que contém o número de cabeçalhos desconhecidos que foram alterados.

ppDiffedUnknownHeaderIndices
[OUT] Um ponteiro para o endereço de uma matriz de DWORD valores, encerrado por um valor –1, que contém os índices de cabeçalhos que foram alterados na lista de cabeçalhos desconhecidos.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor Descrição
S_OK Indica que a operação foi bem-sucedida.
ERROR_NOT_ENOUGH_MEMORY Indica que não há memória suficiente para executar a operação.

Comentários

O IIS usa o GetHeaderChanges método para testar alterações nos cabeçalhos HTTP desde a última vez em que os cabeçalhos foram examinados.

Observação

O IIS usa o GetHeaderChanges método para sincronizar internamente os cabeçalhos entre chamadas para código nativo e gerenciado. Você não deve usar o GetHeaderChanges método ao criar um módulo HTTP.

Requisitos

Type Descrição
Cliente – IIS 7.0 no Windows Vista
– IIS 7.5 no Windows 7
– IIS 8.0 no Windows 8
– IIS 10.0 no Windows 10
Servidor – IIS 7.0 no Windows Server 2008
– IIS 7.5 no Windows Server 2008 R2
– IIS 8.0 no Windows Server 2012
– IIS 8.5 no Windows Server 2012 R2
– IIS 10.0 no Windows Server 2016
Produto - 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
parâmetro Httpserv.h

Consulte Também

IHttpResponse Interface
Método IHttpResponse::GetHeader
Método IHttpRequest::GetHeader
Método IHttpRequest::GetHeaderChanges