IHttpContext::GetServerVariable-Methode

Ruft eine bestimmte Servervariable ab.

Syntax

virtual HRESULT GetServerVariable(  
   PCSTR pszVariableName,  
   PCWSTR * ppszValue,  
   DWORD * pcchValueLength  
) = 0;  
virtual HRESULT GetServerVariable(  
   PCSTR   pszVariableName,  
   PCSTR * ppszValue,  
   DWORD * pcchValueLength  
) = 0;  

Parameter

pszVariableName
Ein Zeiger auf eine Zeichenfolge, die den Namen der zurückzugebenden Servervariable enthält.

ppszValue
Die Adresse eines Zeigers auf einen Zeichenfolgenpuffer, der eine Kopie der Servervariable empfängt.

pcchValueLengthr
Ein Zeiger auf einen DWORD Puffer, der die Länge des ppszValue Parameters empfängt.

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_INVALID_INDEX	Gibt an, dass der Parameter ungültig ist.

Bemerkungen

Die GetServerVariable -Methode ruft eine vom pszVariableName Parameter angegebene Servervariable aus dem aktuellen HTTP-Kontext ab und gibt den Wert in einem Puffer zurück, auf den der ppszValue Parameter verweist. Die durch den -Parameter angegebene Servervariable kann eine benutzerdefinierte Variable oder eine Variable sein, die pszVariableName in RFC 3875 ( Requests for Comments, CGI, Version 1.1) definiert ist.

Hinweis

Die GetServerVariable -Methode unterstützt das Zurückgeben von ANSI- und Unicode-Werten über überladene Methoden. Der Puffer, auf den der ppszValue Parameter verweist, kann entweder ein oder PCSTR seinPCWSTR.

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::SetServerVariable-Methode