IHttpContext::GetServerVarChanges-Methode

Artikel
07/19/2023

Ruft die Änderungen an den Servervariablen für den aktuellen Kontext ab.

Syntax

virtual HRESULT GetServerVarChanges(  
   IN DWORD dwOldChangeNumber,  
   OUT DWORD* pdwNewChangeNumber,  
   IN OUT DWORD* pdwVariableSnapShot,  
   IN OUT PCSTR** ppVariableNameSnapShot,  
   IN OUT PCWSTR** ppVariableValueSnapShot,  
   OUT DWORD* pdwDiffedVariables,  
   OUT DWORD** ppDiffedVariableIndices  
) = 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.

pdwVariableSnapShot
[IN] [OUT] Ein Zeiger auf einenDWORD, der die Anzahl der Servervariablen im Momentaufnahme enthält.

ppVariableNameSnapShot
[IN] [OUT] Ein Zeiger auf die Adresse eines Zeichenfolgenarrays, das die Namen der Servervariablen enthält, die im Momentaufnahme geändert wurden.

ppVariableValueSnapShot
[IN] [OUT] Ein Zeiger auf die Adresse eines Zeichenfolgenarrays, das die Werte der Servervariablen enthält, die im Momentaufnahme geändert wurden.

pdwDiffedVariables
[OUT] Ein Zeiger auf einen DWORD , der die Anzahl der geänderten Servervariablen enthält.

ppDiffedVariableIndices
[OUT] Ein Zeiger auf die Adresse eines Arrays von DWORD Werten, das durch einen -1-Wert beendet wird und die Indizes der geänderten Servervariablen enthält.

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.

Bemerkungen

IIS verwendet die GetServerVarChanges -Methode, um seit der letzten Überprüfung der Servervariablen auf Änderungen an den HTTP-Servervariablen zu testen.

Hinweis

IIS verwendet die GetServerVarChanges -Methode, um die Servervariablen zwischen Aufrufen von nativem und verwaltetem Code intern zu synchronisieren. Entwickler sollten die GetServerVarChanges -Methode beim Erstellen ihrer HTTP-Module nicht verwenden.

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

IHttpContext-Schnittstelle
IHttpContext::GetServerVariable-Methode

Freigeben über