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