Metodo IHttpContext::GetServerVariable

Recupera una variabile server specifica.

Sintassi

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

Parametri

pszVariableName
Puntatore a una stringa contenente il nome della variabile server da restituire.

ppszValue
Indirizzo di un puntatore a un buffer stringa che riceve una copia della variabile server.

pcchValueLengthr
Puntatore a un DWORD buffer che riceve la lunghezza del ppszValue parametro.

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_INVALID_INDEX	Indica che il parametro non è valido.

Commenti

Il GetServerVariable metodo recupera una variabile server specificata dal pszVariableName parametro dal contesto HTTP corrente e restituisce il valore in un buffer a cui punta il ppszValue parametro . La variabile server specificata dal pszVariableName parametro può essere una variabile personalizzata o una variabile definita in Richieste di commenti (RFC) 3875, "The Common Gateway Interface (CGI) Version 1.1".

Nota

Il GetServerVariable metodo supporta la restituzione di valori ANSI e Unicode tramite metodi di overload. Il buffer a cui punta il ppszValue parametro può essere un PCWSTR buffer o PCSTR .

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 IHttpContext
Metodo IHttpContext::SetServerVariable