CHttpServerContext::GetServerVariable

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

Valor de retorno

Diferente de zero se for bem-sucedida, caso contrário, 0. Se a chamada falhar, o Windows função GetLastError pode ser chamado para determinar a causa do erro. 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, exigido tamanho retornado em * 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

Nula finalizada seqüência de caracteres que indica qual variável está sendo solicitada. Consulte a seção Comentários para obter uma lista das variáveis atuais.

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 copia informações relativas a uma conexão HTTP, ou para o próprio servidor, em um buffer fornecido pelo chamador.

Os possíveis valores para lpszVariableNames incluem:

Valor Significado
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.
PATH_INFO Informações de caminho adicionais, como determinado pelo cliente. Isso compreende a parte à direita da URL após o nome da extensão DLL (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 mencionado esta DLL de extensão.
REMOTE_ADDR O endereço IP do cliente.
REMOTE_HOST O nome do host do cliente.
REMOTE_USER Co&ntém o nome de usuário fornecido pelo cliente e autenticado pelo server.nbsp;
REQUEST_METHOD O método de solicitação HTTP.
SCRIPT_NAME O nome da extensão DLL que 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 em que está executando o programa DLL de extensão ISA ou servidor.
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.
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 HTTP
aceitar: * / *; q = 0.1
aceitar: texto/html
aceitar: imagem/jpeg

em seguida, a variável HTTP_ACCEPT terá o valor de:

*/*; q = 0.1, text/html, image/jpeg

Visão geral de CHttpServerContext |nbsp; Membros de classe | Gráfico de hierarquia

Index