IHttpResponse::GetHeaderChanges-Methode

Artikel
07/19/2023

Ruft die Änderungen an den Serverheadern für die aktuelle Antwort ab.

Syntax

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;

Parameter

dwOldChangeNumber
[IN] Ein DWORD , der die alte Änderungsnummer enthält.

pdwNewChangeNumber
[OUT] Ein Zeiger auf einen DWORD , der die neue Änderungsnummer enthält.

knownHeaderSnapshot
[IN] [OUT] Ein Zeiger auf ein Zeichenfolgenarray, das die Momentaufnahme aller bekannten Header enthält. (Das Array enthält beim Aufrufen die neuen Header und enthält bei der Rückgabe die alten Header.)

pdwUnknownHeaderSnapShot
[IN] [OUT] Ein Zeiger auf einen DWORD , der die Anzahl unbekannter Header im Momentaufnahme enthält.

ppUnknownHeaderNameSnapShot
[IN] [OUT] Ein Zeiger auf die Adresse eines Zeichenfolgenarrays, das die Namen aller unbekannten Header enthält. (Das Array enthält beim Aufrufen die neuen Header und enthält bei der Rückgabe die alten Header.)

ppUnknownHeaderValueSnapShot
[IN] [OUT] Ein Zeiger auf die Adresse eines Zeichenfolgenarrays, das eine Liste aller Headerwerte im Momentaufnahme enthält.

diffedKnownHeaderIndices
[OUT] Ein Array von DWORD Werten, das durch einen -1-Wert beendet wird und die Indizes von Headern enthält, die sich in der Liste der bekannten Header geändert haben.

pdwDiffedUnknownHeaders
[OUT] Ein Zeiger auf einen DWORD , der die Anzahl von unbekannten Headern enthält, die geändert wurden.

ppDiffedUnknownHeaderIndices
[OUT] Ein Zeiger auf die Adresse eines Arrays von DWORD Werten, das durch einen -1-Wert beendet wird und die Indizes von Headern enthält, die sich in der Liste der unbekannten Header geändert haben.

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert	BESCHREIBUNG
S_OK	Gibt an, dass der Vorgang erfolgreich war.
ERROR_NOT_ENOUGH_MEMORY	Gibt an, dass nicht genügend Arbeitsspeicher zum Ausführen des Vorgangs vorhanden ist.

Bemerkungen

IIS verwendet die GetHeaderChanges -Methode, um seit der letzten Überprüfung der Header änderungen an den HTTP-Headern zu testen.

Hinweis

IIS verwendet die GetHeaderChanges -Methode, um die Header zwischen Aufrufen von nativem und verwaltetem Code intern zu synchronisieren. Sie sollten die GetHeaderChanges -Methode nicht verwenden, wenn Sie ein HTTP-Modul erstellen.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 unter Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 unter Windows Server 2016
Produkt	– 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
Header	Httpserv.h

Weitere Informationen

IHttpResponse-Schnittstelle
IHttpResponse::GetHeader-Methode
IHttpRequest::GetHeader-Methode
IHttpRequest::GetHeaderChanges-Methode

Freigeben über