Metodo IHttpRequest::GetHeaderChanges

Articolo
07/19/2023

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

Sintassi

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;

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 che contiene lo snapshot di tutte le intestazioni note. La matrice conterrà le nuove intestazioni durante la chiamata e conterrà le intestazioni precedenti durante la restituzione.

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

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

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

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

pdwDiffedUnknownHeaders
[OUT] Puntatore a un DWORD valore che contiene il numero di intestazioni sconosciute modificate.

ppDiffedUnknownHeaderIndices
[OUT] Puntatore all'indirizzo di una matrice di DWORD valori, terminato da un valore -1, che contiene gli indici delle intestazioni modificate 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 è riuscita.
ERROR_NOT_ENOUGH_MEMORY	Indica che la memoria non è sufficiente per eseguire l'operazione.

Commenti

IIS usa il GetHeaderChanges metodo per verificare le modifiche apportate alle intestazioni HTTP dall'ultima analisi delle 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 IHttpRequest
Metodo IHttpRequest::GetHeader
Metodo IHttpResponse::GetHeader
Metodo IHttpResponse::GetHeaderChanges

Condividi tramite