Função HttpQueryInfoA (wininet.h)
Recupera informações de cabeçalho associadas a uma solicitação HTTP.
Sintaxe
BOOL HttpQueryInfoA(
[in] HINTERNET hRequest,
[in] DWORD dwInfoLevel,
[in, out] LPVOID lpBuffer,
[in, out] LPDWORD lpdwBufferLength,
[in, out] LPDWORD lpdwIndex
);
Parâmetros
[in] hRequest
Um identificador retornado por uma chamada para a função HttpOpenRequest ou InternetOpenUrl .
[in] dwInfoLevel
Uma combinação de um atributo a ser recuperado e sinalizadores que modificam a solicitação. Para obter uma lista de possíveis valores de atributo e modificador, consulte Sinalizadores de informações de consulta.
[in, out] lpBuffer
Um ponteiro para um buffer para receber as informações solicitadas. Esse parâmetro não deve ser NULL.
[in, out] lpdwBufferLength
Um ponteiro para uma variável que contém, na entrada, o tamanho em bytes do buffer apontado por lpvBuffer.
Quando a função retorna com êxito, essa variável contém o número de bytes de informações gravadas no buffer. No caso de uma cadeia de caracteres, a contagem de bytes não inclui o caractere nulo de terminação da cadeia de caracteres.
Quando a função
falha com um código de erro estendido de ERROR_INSUFFICIENT_BUFFER, a variável apontada por lpdwBufferLength contém ao sair do tamanho, em bytes, de um buffer grande o suficiente para receber as informações solicitadas. O aplicativo de chamada pode alocar um buffer desse tamanho ou maior e chamar a função novamente.
[in, out] lpdwIndex
Um ponteiro para um índice de cabeçalho baseado em zero usado para enumerar vários cabeçalhos com o mesmo nome. Ao chamar a função , esse parâmetro é o índice do cabeçalho especificado a ser retornado. Quando a função retorna, esse parâmetro é o índice do próximo cabeçalho. Se o próximo índice não puder ser encontrado, ERROR_HTTP_HEADER_NOT_FOUND será retornado.
Retornar valor
Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Você pode recuperar os seguintes tipos de dados de HttpQueryInfo:
- Cadeias de caracteres (padrão)
- SYSTEMTIME (para datas)
- DWORD (para STATUS_CODE, CONTENT_LENGTH e assim por diante, se HTTP_QUERY_FLAG_NUMBER tiver sido usado)
Se o aplicativo exigir que os dados sejam retornados como um tipo de dados diferente de uma cadeia de caracteres, você deverá incluir o modificador apropriado com o atributo passado para dwInfoLevel.
A função HttpQueryInfo está disponível no Microsoft Internet Explorer 3.0 para caracteres ISO-8859-1 (função HttpQueryInfoA) e na Internet Explorer 4.0 ou posterior para caracteres ISO-8859-1 (função HttpQueryInfoA) e para caracteres ISO-8859-1 convertidos em caracteres UTF-16LE.( a função HttpQueryInfoW).
Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.
Observação
O cabeçalho wininet.h define HttpQueryInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wininet.h |
| Biblioteca | Wininet.lib |
| DLL | Wininet.dll |