IHttpContext::GetServerVariable (Método)

Recupera una variable de servidor específica.

Sintaxis

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

Parámetros

pszVariableName
Puntero a una cadena que contiene el nombre de la variable de servidor que se va a devolver.

ppszValue
Dirección de un puntero a un búfer de cadenas que recibe una copia de la variable de servidor.

pcchValueLengthr
Puntero a un DWORD búfer que recibe la longitud del ppszValue parámetro.

Valor devuelto

Una clase HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Valor	Descripción
S_OK	Indica que la operación se realizó correctamente.
ERROR_INVALID_INDEX	Indica que el parámetro no es válido.

Comentarios

El GetServerVariable método recupera una variable de servidor especificada por el pszVariableName parámetro del contexto HTTP actual y devuelve el valor de un búfer al que apunta el ppszValue parámetro . La variable de servidor especificada por el pszVariableName parámetro puede ser una variable personalizada o una variable definida en Requests for Comments (RFC) 3875, "The Common Gateway Interface (CGI) Version 1.1".

Nota

El GetServerVariable método admite la devolución de valores ANSI y Unicode mediante métodos sobrecargados. El búfer al que apunta el ppszValue parámetro puede ser un PCWSTR búfer o PCSTR .

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Servidor	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- 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
Encabezado	Httpserv.h

Consulte también

IHttpContext (interfaz)
IHttpContext::SetServerVariable (Método)