CHttpFilterContext::GetServerVariable

BOOL GetServerVariable (LPTSTR lpszVariableName, LPVOID lpvBuffer, LPDWORD lpdwSize );

Valor devuelto

Distinto de cero si es correcto, de lo contrario 0. La llamada a la API de Win32 GetLastError puede utilizarse para determinar la razón del error de la llamada. Valores de error posible incluir

Valor Significado
ERROR_INVALID_PARAMETER Identificador de mala conexión.
ERROR_INVALID_INDEX Identificador de la variable mal o no es compatible.
ERROR_INSUFFICIENT_BUFFER Búfer demasiado pequeño; el tamaño requerido es devuelto en lpdwSize.
ERROR_MORE_DATA Búfer demasiado pequeño, sólo una parte de los datos devueltos. No se devuelve el tamaño total de los datos.
ERROR_NO_DATA La información solicitada no está disponible.

Parámetros

lpszVariableName

Se solicita que indica que la variable de cadena terminada en nulo. Vea la sección de comentarios a continuación una selección de posibles nombres. Todos los nombres de variables están definidos en la especificación CGI ubicada en http://hoohoo.ncsa.uiuc.edu/cgi/env.html.

lpvBuffer

Puntero al búfer para recibir la información solicitada.

lpdwSize

Puntero a DWORD que indica el número de bytes disponibles en el búfer. Al finalizar con éxito el valor DWORD contiene el número de bytes transferidos en el búfer (incluyendo el byte null de terminación).

Observaciones

Esta función miembro es llamada por el marco para copiar información relativa a una conexión HTTP o al servidor de sí mismo, en un búfer suministrado por el llamador. Incluir posibles lpszVariableNames:

Valor Significado
ALL_HTTP Todos los encabezados HTTP que no se han analizado ya en una de las variables mencionadas. Estas variables son de la forma HTTP_lt; nombre de encabezado de campo & gt.
AUTH_TYPE Contiene el tipo de autenticación used.nbsp; Por ejemplo, si utiliza la autenticación básica, la cadena será "Basic". Desafío / respuesta de Windows &NT, será "NTLM". Otros esquemas de autenticación tendrá otras cadenas. Porque pueden agregarse nuevos tipos de autenticación al servidor de Internet, no es posible enumerar todas las cadenas posibles. Si la cadena está vacía autenticación no se utiliza.
CONTENT_LENGTH El número de bytes que la secuencia de comandos puede esperar recibir del cliente.
CONTENT_TYPE El tipo de contenido de la información suministrada en el cuerpo de una solicitud POST.
GATEWAY_INTERFACE La revisión de la especificación CGI para que se cumpla este servidor. La versión actual es CGI/1.1.
HTTP_ACCEPT Encabezado HTTP de caso especial. Valores de aceptar: se concatenan campos, separados por ",". Por ejemplo, si las líneas siguientes son parte del encabezado HTTP
aceptar: * / *; q = 0,1
aceptar: texto/html
aceptar: image/jpeg

entonces la variable HTTP_ACCEPT tendrá un valor de:

*/*; q = 0,1, texto/html, image/jpeg
PATH_INFO Información de ruta adicional, como determinado por el cliente. Esto comprende la parte final de la URL después el nombre del script, pero antes la cadena de consulta (si corresponde).
PATH_TRANSLATED Este es el valor de PATH_INFO, pero con cualquier nombre de ruta de acceso virtual se expandió a una especificación de directorio.
QUERY_STRING La información que sigue la ? en la dirección URL que hace referencia esta secuencia de comandos.
REMOTE_ADDR La dirección IP del cliente.
REMOTE_HOST El nombre de host del cliente.
REMOTE_USER Contiene el nombre de usuario proporcionado por el cliente y el servidor autentica.
REQUEST_METHOD El método de petición HTTP.
SCRIPT_NAME El nombre del programa de secuencia de comandos se ejecuta.
NOMBRE_SERVIDOR El servidor host (o dirección IP) que debe aparecer en las direcciones URL de autorreferencia.
SERVER_PORT El puerto TCP/IP en el que se recibió la solicitud.
SERVER_PROTOCOL El nombre y la versión del Protocolo de recuperación de información relativa a esta solicitud. Normalmente HTTP/1.0.
SERVER_SOFTWARE El nombre y la versión del servidor web que se está ejecutando el programa CGI.

Visión General de CHttpFilterContext |nbsp; Miembros de clase | Diagrama de jerarquía

Index