CHttpFile::QueryInfo

BOOL QueryInfo (DWORD dwInfoLevel, LPVOID lpvBuffer, LPDWORD lpdwBufferLength, LPDWORD lpdwIndex = NULL) const;

BOOL QueryInfo (DWORD dwInfoLevelCString&улLPDWORDdwIndex= NULL) const;

BOOL QueryInfo (DWORD dwInfoLevel, SYSTEMTIME * pSysTime, LPDWORD dwIndex = NULL) const;

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

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

Параметры

dwInfoLevel

Сочетание атрибута для запросов и следующие флаги, определяющие тип запрашиваемой информации:

• HTTP_QUERY_CUSTOM   Находит имя заголовка и возвращает это значение в lpvBuffer на выходе. HTTP_QUERY_CUSTOM вызывает утверждение, если заголовок не найден.
  
  
• HTTP_QUERY_FLAG_REQUEST_HEADERS   Как правило приложение запрашивает заголовков ответа, однако приложение может также запрашивать заголовков запроса, используя этот флаг.
  
  
• HTTP_QUERY_FLAG_SYSTEMTIME   Для этих заголовков, значением которого является строка даты и времени, такие, как «Последний-изменения-время,» этот флаг возвращает значение заголовка как стандартный Win32 структура SYSTEMTIME , которая не требует приложения для анализа данных. Если вы используете этот флаг, может потребоваться использовать SYSTEMTIME переопределение функции.
  
  
• HTTP_QUERY_FLAG_&NUMBERnbsp;  Для этих заголовков, значением которого является число, например код состояния этот флаг возвращает данные как 32-битное число.

  В разделе примечания для получения списка возможных значений.

lpvBuffer

Указатель на буфер, который получает информацию.

lpdwBufferLength

На въезд это указывает на значение, содержащее длину буфера данных, количество символов или байтов. Более подробную информацию о этот параметр в разделе примечания.

lpdwIndex

Указатель индекс (с нуля) заголовка. Может иметь значение NULL. Используйте этот флаг для перечисления нескольких заголовков с тем же именем. На входе lpdwIndex указывает индекс указанного заголовка для возвращения. На выходе lpdwIndex указывает индекс следующего заголовка. Если не удается найти следующий индекс, ERROR_HTTP_HEADER_NOT_FOUND возвращается.

ул

Ссылка на объект CString , получения возвращенных данных.

dwIndex

Значение индекса. Посмотреть lpdwIndex.

pSysTime

Указатель на Win32 структура SYSTEMTIME.

Примечания

Вызовите эту функцию-член возвращать ответ или запросить заголовки из HTTP-запроса. Используйте эту функцию-член только после успешного вызова для SendRequest или на CHttpFile объекте успешно создан OpenURL.

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

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

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

Возможные dwInfoLevel значения:

• HTTP_QUERY_MIME_VERSION
  
  
• HTTP_QUERY_CONTENT_TYPE
  
  
• HTTP_QUERY_CONTENT_TRANSFER_ENCODING
  
  
• HTTP_QUERY_CONTENT_ID
  
  
• HTTP_QUERY_CONTENT_DESCRIPTION
  
  
• HTTP_QUERY_CONTENT_LENGTH
  
  
• HTTP_QUERY_ALLOWED_METHODS
  
  
• HTTP_QUERY_PUBLIC_METHODS
  
  
• HTTP_QUERY_DATE
  
  
• HTTP_QUERY_EXPIRES
  
  
• HTTP_QUERY_LAST_MODIFIED
  
  
• HTTP_QUERY_MESSAGE_ID
  
  
• HTTP_QUERY_URI
  
  
• HTTP_QUERY_DERIVED_FROM
  
  
• HTTP_QUERY_LANGUAGE
  
  
• HTTP_QUERY_COST
  
  
• HTTP_QUERY_WWW_LINK
  
  
• HTTP_QUERY_PRAGMA
  
  
• HTTP_QUERY_VERSION
  
  
• HTTP_QUERY_STATUS_CODE
  
  
• HTTP_QUERY_STATUS_TEXT
  
  
• HTTP_QUERY_RAW_HEADERS
  
  
• HTTP_QUERY_RAW_HEADERS_CRLF

Обзор CHttpFile |  Члены класса | Иерархическая схема

См. также CInternetFile, CHttpConnection::OpenRequest, CFtpConnection, CGopherConnection, CInternetConnection