CHttpFile::QueryInfo

Artigo
08/25/2010

Chame essa função de membro para retornar a resposta ou solicitar cabeçalhos 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 do atributo para consulta e os seguintes sinalizadores que especificam o tipo de informações solicitadas:
- HTTP_QUERY_CUSTOM Localiza o nome do cabeçalho e retorna esse valor em lpvBuffer na saída. HTTP_QUERY_CUSTOM lança 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 esse sinalizar.
- HTTP_QUERY_FLAG_SYSTEMTIMEPara esses cabeçalhos cujo valor é uma seqüência de caracteres de data/time, sistema autônomo "Última modificação-time," Este sinalizar retorna o valor do cabeçalho sistema autônomo um Win32 padrão SYSTEMTIME estrutura que não requer o aplicativo para analisar sistema autônomo dados.Se você usar esse sinalizar, convém usar o SYSTEMTIME substituir da função.
- HTTP_QUERY_FLAG_NUMBER Esses cabeçalhos cujo valor é um número, sistema autônomo o código de status, esse sinalizar retorna sistema autônomo dados sistema autônomo um número de 32 bit.
Consulte o Comentários seção para obter uma lista dos valores possíveis.
lpvBuffer
Um ponteiro para o buffer que receberá as informações.
lpdwBufferLength
Na entrada, isso aponta para um valor que contém o comprimento do buffer de dados, em número de caracteres ou bytes.Consulte o Comentários seção para obter informações mais detalhadas sobre este parâmetro.
lpdwIndex
Um ponteiro para um índice de cabeçalho com base em zero.Pode ser NULO.Use este sinalizar para enumerar vários cabeçalhos com o mesmo nome.Na entrada, lpdwIndex indica o índice do cabeçalho especificado para retornar. Na saída, lpdwIndex indica o índice do próximo cabeçalho. Se o próximo índice não for encontrado, ERROR_HTTP_HEADER_NOT_FOUND será retornado.
str
Uma referência para o CString objeto receber as informações retornadas.
dwIndex
Um valor de índice.Consulte lpdwIndex.
pSysTime
Um ponteiro para um Win32 SYSTEMTIME estrutura.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.Se a telefonar falhar, o Win32 funcionar GetLastError pode ser chamado para determinar a causa do erro.

Comentários

Use esta função de membro somente após uma telefonar bem-sucedida para SendRequest or on a CHttpFile objeto criado com êxito pelo OpenURL.

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

seqüências de caracteres (padrão)
SYSTEMTIME(para "dados:" "Vence:" etc., cabeçalhos)
DWORD (para STATUS_CODE, CONTENT_LENGTH, etc.)

Quando uma seqüência de caracteres foi criada para o buffer e a função de membro tiver êxito, lpdwBufferLength contém o comprimento da seqüência de caracteres em caracteres menos 1 para o encerramento NULO caractere.

O possível dwInfoLevel os valores incluem: