CHttpFile::QueryInfo

BOOL QueryInfo (DWORD dwInfoLevel, LPVOID lpvBuffer, LPDWORD lpdwBufferLength, LPDWORD lpdwIndex = NULL) константа;

BOOL QueryInfo (DWORD dwInfoLevelCString&вулLPDWORDdwIndex= NULL) константа;

BOOL QueryInfo (DWORD dwInfoLevel, SYSTEMTIME * pSysTime, LPDWORD dwIndex = NULL) константа;

Значення, яке повертається

Ненульовий, у разі успіху; в іншому випадку 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

Вказівник на COLUMN заголовок покажчика. Може бути NULL. Використовувати цей прапор пронумерувати групу заголовків із таким ім'ям. При вводі lpdwIndex вказує Індекс вказаного заголовок, щоб повернутися. На вихід lpdwIndex вказує індекс наступного заголовка. Якщо не вдається знайти наступний індекс, ERROR_HTTP_HEADER_NOT_FOUND повертається.

вул

Посилання на об'єкт CString , отримання повернених даних.

dwIndex

Значення індексу. Див lpdwIndex.

pSysTime

Вказівник миші, щоб Win32 SYSTEMTIME структури.

Зауваження

Телефонуйте цієї функції-члена на повернення відповідь або запит заголовки з HTTP-запиту. За допомогою цієї функції-члени тільки після успішного виклику SendRequest або CHttpFile об'єкта, успішно створений OpenURL.

Можна отримати такі типи даних із QueryInfo:

• рядки (за замовчуванням)
  
  
• SYSTEMTIME (для "дані:" "закінчується:" тощо, заголовки)
  
  
• 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