CHttpFile::QueryInfo

Artigo
02/25/2013

Chamar essa função de membro para retornar cabeçalhos de resposta ou de solicitação de uma solicitação HTTP.

BOOL QueryInfo(
   DWORD dwInfoLevel,
   LPVOID lpvBuffer,
   LPDWORD lpdwBufferLength,
   LPDWORD lpdwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   CString& str,
   LPDWORD dwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   SYSTEMTIME* pSysTime,
   LPDWORD dwIndex = NULL 
) const;

Parâmetros

dwInfoLevel
Uma combinação de atributos a consulte e os seguintes sinalizações que especifiquem o tipo de informações aplicativo:
- HTTP_QUERY_CUSTOM encontrar o nome do cabeçalho e retorna o valor de lpvBuffer na saída.HTTP_QUERY_CUSTOM gera uma declaração se o cabeçalho não for encontrado.
- HTTP_QUERY_FLAG_REQUEST_HEADERS normalmente, o aplicativo consulta os cabeçalhos de resposta, mas um aplicativo também pode consultar cabeçalhos de solicitação usando este sinalizador.
- HTTP_QUERY_FLAG_SYSTEMTIME para os cabeçalhos cujo valor é uma cadeia de caracteres de data/hora, como “Último-Alterar- Hora,” returns de este sinalizador o valor de cabeçalho como uma estrutura SYSTEMTIME do Win32 padrão que não requer o aplicativo analisar os dados.Se você usar este sinalizador, você pode querer usar substituição de SYSTEMTIME de função.
- HTTP_QUERY_FLAG_NUMBER para os cabeçalhos cujo valor é um número, como o código de status de este sinalizador, retorna os dados como um número de 32 bits.
Consulte a seção de Comentários para obter uma lista de valores possíveis.
lpvBuffer
Um ponteiro para o buffer que recebe informações.
lpdwBufferLength
Em a entrada, em esses pontos como um valor que contém o comprimento do buffer de dados, no número de caracteres ou de bytes.Consulte a seção de Comentários para informações mais detalhadas sobre este parâmetro.
lpdwIndex
Um ponteiro para um índice com base zero do cabeçalho.Pode ser NULO.Use este sinalizador para enumerar vários cabeçalhos com o mesmo nome.Em a entrada, lpdwIndex indica o índice especificado de cabeçalho para retornar.Em a saída, lpdwIndex indica o índice do cabeçalho seguir.Se o índice seguir não pode ser encontrado, ERROR_HTTP_HEADER_NOT_FOUND será retornado.
str
Uma referência ao objeto de CString que recebe informações retornado.
dwIndex
Um valor de índice.Consulte lpdwIndex.
pSysTime
Um ponteiro a estrutura do Win32 SYSTEMTIME .

Valor de retorno

Diferente de zero se com êxito; se não 0.Se a chamada falha, a função GetLastError Win32 pode ser chamado para determinar a causa do erro.

Comentários

Use esta função de membro somente após uma chamada com êxito a SendRequest ou em um objeto de CHttpFile criado com êxito por OpenURL.

Você pode recuperar os seguintes tipos de dados de QueryInfo:

cadeias de caracteres (padrão)
SYSTEMTIME (para “dados: ” “Expira: ” cabeçalhos, etc.)
DWORD (para STATUS_CODE, CONTENT_LENGTH, etc..)

Quando uma cadeia de caracteres é gravada no buffer, e a função de membro tiver êxito, lpdwBufferLength contém o comprimento da cadeia de caracteres em caracteres menos 1 para o caractere de terminação de NULO .

Os valores possíveis de dwInfoLevel incluem: