Metodo IHttpResponse::GetHeaderChanges

Articolo
07/19/2023

Recupera le modifiche apportate alle intestazioni del server per la risposta corrente.

Sintassi

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;

Parametri

dwOldChangeNumber
[IN] Oggetto DWORD contenente il numero di modifica precedente.

pdwNewChangeNumber
[OUT] Puntatore a un DWORD oggetto contenente il nuovo numero di modifica.

knownHeaderSnapshot
[IN] [OUT] Puntatore a una matrice di stringhe contenente lo snapshot di tutte le intestazioni note. La matrice conterrà le nuove intestazioni quando si chiama e conterrà le intestazioni precedenti durante la restituzione.

pdwUnknownHeaderSnapShot
[IN] [OUT] Puntatore a un DWORD oggetto contenente il numero di intestazioni sconosciute nello snapshot.

ppUnknownHeaderNameSnapShot
[IN] [OUT] Puntatore all'indirizzo di una matrice di stringhe contenente i nomi di tutte le intestazioni sconosciute. La matrice conterrà le nuove intestazioni quando si chiama e conterrà le intestazioni precedenti durante la restituzione.

ppUnknownHeaderValueSnapShot
[IN] [OUT] Puntatore all'indirizzo di una matrice di stringhe che contiene un elenco di tutti i valori di intestazione nello snapshot.

diffedKnownHeaderIndices
[OUT] Matrice di valori, terminata da un valore -1, che contiene gli indici di DWORD intestazioni che sono stati modificati nell'elenco delle intestazioni note.

pdwDiffedUnknownHeaders
[OUT] Puntatore a un DWORD oggetto contenente il numero di intestazioni sconosciute modificate.

ppDiffedUnknownHeaderIndices
[OUT] Puntatore all'indirizzo di una matrice di valori, terminato da un valore -1, che contiene gli indici di DWORD intestazioni che sono stati modificati nell'elenco di intestazioni sconosciute.

Valore restituito

Oggetto HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Valore	Descrizione
S_OK	Indica che l'operazione ha avuto esito positivo.
ERROR_NOT_ENOUGH_MEMORY	Indica che la memoria non è sufficiente per eseguire l'operazione.

Commenti

IIS usa il GetHeaderChanges metodo per testare le modifiche alle intestazioni HTTP dall'ultima volta che sono state esaminate le intestazioni.

Nota

IIS usa il GetHeaderChanges metodo per sincronizzare internamente le intestazioni tra le chiamate al codice nativo e gestito. Non è consigliabile usare il GetHeaderChanges metodo quando si crea un modulo HTTP.

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- 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
Intestazione	Httpserv.h

Vedere anche

Interfaccia IHttpResponse
Metodo IHttpResponse::GetHeader
Metodo IHttpRequest::GetHeader
Metodo IHttpRequest::GetHeaderChanges

Condividi tramite