CHttpFile::QueryInfo

Статья
02/20/2013

Эта функция-член вызывается с целью возврата ответа или заголовки запроса из 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;

Параметры

dwInfoLevel
Сочетание атрибут для запросов и следующие флаги, определяющие тип сведений запросила:
- Имя заголовка HTTP_QUERY_CUSTOM находит и возвращает его в lpvBuffer на выходе.HTTP_QUERY_CUSTOM вызывает проверочное утверждение, если заголовок не найден.
- HTTP_QUERY_FLAG_REQUEST_HEADERS Обычно приложение запрашивает заголовки ответа, но приложение также может запросить заголовки запроса с помощью этого пометить.
- HTTP_QUERY_FLAG_SYSTEMTIME Для этих заголовков, значение которых строка даты и времени, Последн-Дорабатывать- как "Time" получения этого значения заголовка пометить как стандартная структура Win32 SYSTEMTIME, которая не требует приложения анализа данных.При использовании этого пометить можно использовать переопределение SYSTEMTIME функции.
- HTTP_QUERY_FLAG_NUMBER Для этих заголовков, значение которых число, как код состояния передачи этого пометить данные как 32 цифр.
См. раздел Примечания список возможных значений.
lpvBuffer
Указатель на буфер, получающий сведения.
lpdwBufferLength
Для записи этих точках к содержащему длина буфера данных, число символов или байтов.См. раздел Примечания дополнительные сведения об этом параметре.
lpdwIndex
Указатель на основе нулевой- индекс заголовка.Может быть NULL.Используйте этот пометить для перечисления несколько заголовков с тем же именем.На входе, lpdwIndex указывающее индекс указанного заголовка.На выходе, lpdwIndex указывающее индекс следующего заголовка.Если следующий индекс не найден, то возвращается ERROR_HTTP_HEADER_NOT_FOUND.
str
Ссылка на объект CString при получении возвращающие сведения.
dwIndex
Значение индекса.Дополнительные сведения см. в разделе lpdwIndex.
pSysTime
Указатель на структуру SYSTEMTIME Win32.

Возвращаемое значение

Ненулевой, если успешно; в противном случае – значение 0.Если вызов завершается с ошибкой, то функция Win32 GetLastError может быть называется, чтобы определить причину ошибки.

Заметки

Используйте этот функции-члена только после успешного вызова метода SendRequest или на объекте, созданном OpenURLCHttpFile успешно.

Можно извлечь из QueryInfo следующие типы данных:

строки (по умолчанию)
SYSTEMTIME (для "данных. " "Срок действия: заголовки) и т д
DWORD (для STATUS_CODE, CONTENT_LENGTH и т д).

Если строка записана в буфер, а функция-член завершается успешно, lpdwBufferLength содержит длину строки в символах минус 1 для конечного знака NULL.

Возможные значения dwInfoLevel включают: