BOOL GetServerVariable (LPTSTR lpszVariableName, LPVOID lpvBuffer, out lpdwSize );
Valor de retorno
Diferente de zero se for bem-sucedida, caso contrário, 0. A chamada de API do Win32 GetLastError pode ser usado para determinar por que a chamada falhou. Valores de erro possíveis incluem
| Valor | Significado |
| ERROR_INVALID_PARAMETER | Identificador de conexão ruim. |
| ERROR_INVALID_INDEX | Identificador de variável inválido ou sem suporte. |
| ERROR_INSUFFICIENT_BUFFER | Buffer muito pequeno; o tamanho necessário é retornado no lpdwSize. |
| ERROR_MORE_DATA | Buffer muito pequeno, apenas parte dos dados retornados. O tamanho total dos dados não é retornado. |
| ERROR_NO_DATA | Os dados solicitados não estão disponíveis. |
Parâmetros
lpszVariableName
Seqüência de caracteres NULL-terminated que indica qual variável está sendo solicitada. Consulte a seção de comentários abaixo para uma seleção de nomes possíveis. Todos os nomes de variáveis são definidos na especificação de CGI localizada em http://hoohoo.ncsa.uiuc.edu/cgi/env.html.
lpvBuffer
Ponteiro para o buffer para receber as informações solicitadas.
lpdwSize
Ponteiro para DWORD indicando o número de bytes disponíveis no buffer. Na conclusão bem-sucedida, o DWORD contém o número de bytes transferidos para a reserva (incluindo o byte null-terminating).
Observações
Esta função de membro é chamada pela estrutura para copiar as informações relativas a uma conexão HTTP, ou para o próprio servidor, em um buffer fornecido pelo chamador. Possível lpszVariableNames incluem:
| Valor | Significado |
| ALL_HTTP | Todos os cabeçalhos HTTP que não eram já analisados em uma das variáveis acima. Essas variáveis são a forma HTTP_lt; nome de campo de cabeçalho & gt. |
| AUTH_TYPE | Contém o tipo de autenticação used.nbsp; Por exemplo, se a autenticação básica é usada, a Cadeia de caracteres será "Basic". Para Windows &NT desafio-resposta, será "NTLM". Outros esquemas de autenticação terão outras seqüências de caracteres. Porque novos tipos de autenticação podem ser adicionados ao servidor de Internet, não é possível enumerar todas as seqüências de caracteres possíveis. Se a Cadeia de caracteres estiver vazia, nenhuma autenticação é usada. |
| CONTENT_LENGTH | O número de bytes que o script pode esperar receber do cliente. |
| CONTENT_TYPE | O tipo de conteúdo das informações fornecidas no corpo de uma solicitação POST. |
| GATEWAY_INTERFACE | A revisão da especificação de CGI, ao qual este servidor é compatível. A versão atual é CGI/1.1. |
| HTTP_ACCEPT | Cabeçalho HTTP de caso especial. Valores da aceitar: campos são concatenados, separados por ",". Por exemplo, se as linhas a seguir são parte do cabeçalho HTTPem seguida, a variável HTTP_ACCEPT terá o valor de: |
| PATH_INFO | Informações de caminho adicionais, como determinado pelo cliente. Isso compreende a parte à direita da URL após o nome do script, mas antes a Cadeia de caracteres de consulta (se houver). |
| PATH_TRANSLATED | Este é o valor de PATH_INFO, mas com nenhum nome de caminho virtual expandido em uma especificação de diretório. |
| QUERY_STRING | As informações que segue o ? na URL que relacionado esse script. |
| REMOTE_ADDR | O endereço IP do cliente. |
| REMOTE_HOST | O nome do host do cliente. |
| REMOTE_USER | Contém o nome de usuário fornecido pelo cliente e autenticado pelo servidor. |
| REQUEST_METHOD | O método de solicitação HTTP. |
| SCRIPT_NAME | O nome do programa script está sendo executado. |
| NOME_DO_SERVIDOR | Nome do host do servidor (ou endereço IP) como ela deve aparecer em URLs de auto-referência. |
| SERVER_PORT | A porta de TCP/IP no qual a solicitação foi recebida. |
| SERVER_PROTOCOL | O nome e a versão do protocolo de recuperação de informação relativo a este pedido. Normalmente HTTP/1.0. |
| SERVER_SOFTWARE | O nome e versão do servidor web que está executando o programa CGI. |
Visão geral de CHttpFilterContext |nbsp; Membros de classe | Gráfico de hierarquia