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 HTTPentonces la variable HTTP_ACCEPT tendrá un valor de: |
| 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