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