CHttpServerContext::GetServerVariable

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

Valor devuelto

Distinto de cero si es correcto, de lo contrario 0. Si la llamada falla, la función de Windows GetLastError puede ser llamado para determinar la causa del error. 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 de tamaño demasiado pequeño, requiere regresado 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 cadena terminada en nulo que indica qué variable. Vea la sección de comentarios para obtener una lista de las variables actuales.

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 DWORD contiene el número de bytes transferidos en el búfer (incluyendo el byte null de terminación).

Observaciones

Esta función copia información relativa a una conexión HTTP o al servidor de sí mismo, en un búfer suministrado por el llamador.

Los valores posibles de lpszVariableNames incluyen:

Valor	Significado
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, entonces no se utiliza autenticación.
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.
PATH_INFO	Información de ruta adicional, como determinado por el cliente. Esto comprende la parte final de la URL después del nombre de la DLL (script) de extensión, 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 a la? en la dirección URL que hace referencia a este archivo DLL de extensión.
REMOTE_ADDR	La dirección IP del cliente.
REMOTE_HOST	El nombre de host del cliente.
REMOTE_USER	Co&ntiene el nombre de usuario proporcionado por el cliente y autenticado por el server.nbsp;
REQUEST_METHOD	El método de petición HTTP.
SCRIPT_NAME	El nombre de la extensión del archivo DLL que se está ejecutando.
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 de DLL de extensión de ISA o servidor.
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.
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`

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

Index