IHttpRequest::GetHeaderChanges-Methode

Artikel
07/19/2023

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

Syntax

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;

Parameter

dwOldChangeNumber
[IN] Eine DWORD , die 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 beim Zurückgeben die alten Header.)

pdwUnknownHeaderSnapShot
[IN] [OUT] Ein Zeiger auf einenDWORD, 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 beim Zurückgeben 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 die Indizes von Headern enthalten, die sich in der Liste der bekannten Header geändert haben.

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

ppDiffedUnknownHeaderIndices
[OUT] Ein Zeiger auf die Adresse eines Arrays von DWORD Werten, das durch einen -1-Wert beendet wird und die die Indizes von Headern enthalten, 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 auf Ä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 auf 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 auf 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

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

Freigeben über