Флаги сведений о запросе (Wininet.h)

Следующие списки содержат атрибуты и модификаторы, используемые HttpQueryInfo и QueryInfo.

Флаги атрибутов используются HttpQueryInfo (или QueryInfo), чтобы указать, какие данные следует извлечь. Большинство флагов атрибутов сопоставляется непосредственно с определенным заголовком HTTP. Существуют также специальные флаги, например HTTP_QUERY_RAW_HEADERS, которые не связаны с определенным заголовком.

HTTP_QUERY_ACCEPT

24

Извлекает допустимые типы мультимедиа для ответа.

HTTP_QUERY_ACCEPT_CHARSET

25

Извлекает допустимые наборы символов для ответа.

HTTP_QUERY_ACCEPT_ENCODING

26

Извлекает допустимые значения кода содержимого для ответа.

HTTP_QUERY_ACCEPT_LANGUAGE

27

Извлекает приемлемые естественные языки для ответа.

HTTP_QUERY_ACCEPT_RANGES

42

Извлекает типы запросов диапазона, которые принимаются для ресурса.

HTTP_QUERY_AGE

48

Извлекает поле Заголовок ответа Age, содержащее оценку отправителя времени с момента создания ответа на сервере-источнике.

HTTP_QUERY_ALLOW

7

Получает HTTP-команды, поддерживаемые сервером.

HTTP_QUERY_AUTHORIZATION

28

Извлекает учетные данные авторизации, используемые для запроса.

HTTP_QUERY_CACHE_CONTROL

49

Извлекает директивы управления кэшем.

HTTP_QUERY_CONNECTION

23

Извлекает все параметры, указанные для определенного подключения и не должны передаваться прокси-серверами через дальнейшие подключения.

HTTP_QUERY_CONTENT_BASE

50

Извлекает базовый URI (универсальный идентификатор ресурса) для разрешения относительных URL-адресов в сущности.

HTTP_QUERY_CONTENT_DESCRIPTION

4

Является устаревшей. Поддерживается только для обеспечения совместимости устаревших приложений.

HTTP_QUERY_CONTENT_DISPOSITION

47

Является устаревшей. Поддерживается только для обеспечения совместимости устаревших приложений.

HTTP_QUERY_CONTENT_ENCODING

29

Извлекает все дополнительные коды содержимого, которые были применены ко всему ресурсу.

HTTP_QUERY_CONTENT_ID

3

Извлекает идентификацию содержимого.

HTTP_QUERY_CONTENT_LANGUAGE

6

Извлекает язык, на который находится содержимое.

HTTP_QUERY_CONTENT_LENGTH

5

Извлекает размер ресурса в байтах.

HTTP_QUERY_CONTENT_LOCATION

51

Извлекает расположение ресурса для сущности, заключенной в сообщение.

HTTP_QUERY_CONTENT_MD5

52

Извлекает хэш MD5 тела сущности для обеспечения сквозной целостности сообщений проверка (MIC) для тела сущности. Дополнительные сведения см. в разделе RFC1864, поле заголовка Content-MD5 по адресу https://ftp.isi.edu/in-notes/rfc1864.txt.

HTTP_QUERY_CONTENT_RANGE

53

Извлекает расположение в полном теле сущности, куда следует вставить частичную сущность-тело, и общий размер полного тела сущности.

HTTP_QUERY_CONTENT_TRANSFER_ENCODING

2

Получает дополнительный код содержимого, примененный к ресурсу.

HTTP_QUERY_CONTENT_TYPE

1

Получает тип контента ресурса (например, text/html).

HTTP_QUERY_COOKIE

44

Извлекает все файлы cookie, связанные с запросом.

HTTP_QUERY_COST

15

Больше не поддерживается.

HTTP_QUERY_CUSTOM

65535

Вызывает httpQueryInfo для поиска имени заголовка, указанного в lpvBuffer , и сохранения данных заголовка в lpvBuffer.

HTTP_QUERY_DATE

9

Получает дату и время создания сообщения.

HTTP_QUERY_DERIVED_FROM

14

Больше не поддерживается.

HTTP_QUERY_ECHO_HEADERS

73

В настоящий момент не реализовано.

HTTP_QUERY_ECHO_HEADERS_CRLF

74

В настоящий момент не реализовано.

HTTP_QUERY_ECHO_REPLY

72

В настоящий момент не реализовано.

HTTP_QUERY_ECHO_REQUEST

71

В настоящий момент не реализовано.

HTTP_QUERY_ETAG

54

Извлекает тег сущности для связанной сущности.

HTTP_QUERY_EXPECT

68

Извлекает заголовок Expect, который указывает, должно ли клиентское приложение ожидать ответов серии 100.

HTTP_QUERY_EXPIRES

10

Получает дату и время, после которых ресурс следует считать устаревшим.

HTTP_QUERY_FORWARDED

30

Является устаревшей. Поддерживается только для обеспечения совместимости устаревших приложений.

HTTP_QUERY_FROM

31

Извлекает адрес электронной почты пользователя-человека, который управляет запрашивающим агентом пользователя, если задан заголовок From.

HTTP_QUERY_HOST

55

Извлекает узел Интернета и номер порта запрашиваемого ресурса.

HTTP_QUERY_IF_MATCH

56

Извлекает содержимое поля If-Match заголовка запроса.

HTTP_QUERY_IF_MODIFIED_SINCE

32

Извлекает содержимое заголовка If-Modified-Since.

HTTP_QUERY_IF_NONE_MATCH

57

Извлекает содержимое поля If-None-Match request-header.

HTTP_QUERY_IF_RANGE

58

Извлекает содержимое поля If-Range заголовка запроса. Этот заголовок позволяет клиентскому приложению убедиться, что сущность, связанная с частичной копией сущности в кэше клиентских приложений, не была обновлена. Если сущность не была обновлена, отправьте части, отсутствующие в клиентском приложении. Если сущность была обновлена, отправьте всю обновленную сущность.

HTTP_QUERY_IF_UNMODIFIED_SINCE

59

Извлекает содержимое поля заголовок запроса If-Unmodified-Since.

HTTP_QUERY_LAST_MODIFIED

11

Получает дату и время, когда сервер считает, что ресурс был изменен в последний раз.

HTTP_QUERY_LINK

16

Является устаревшей. Поддерживается только для обеспечения совместимости устаревших приложений.

HTTP_QUERY_LOCATION

33

Извлекает абсолютный универсальный код ресурса (URI), используемый в заголовке ответа Location.

HTTP_QUERY_MAX

78

Не флаг запроса. Указывает максимальное значение значения HTTP_QUERY_*.

HTTP_QUERY_MAX_FORWARDS

60

Извлекает количество прокси-серверов или шлюзов, которые могут перенаправить запрос на следующий входящий сервер.

HTTP_QUERY_MESSAGE_ID

12

Больше не поддерживается.

HTTP_QUERY_MIME_VERSION

0

Получает версию протокола MIME, который использовался для создания сообщения.

HTTP_QUERY_ORIG_URI

34

Является устаревшей. Поддерживается только для обеспечения совместимости устаревших приложений.

HTTP_QUERY_PRAGMA

17

Получает директивы, относящиеся к реализации, которые могут применяться к любому получателю в цепочке "запрос-ответ".

HTTP_QUERY_PROXY_AUTHENTICATE

41

Извлекает схему проверки подлинности и область, возвращенную прокси-сервером.

HTTP_QUERY_PROXY_AUTHORIZATION

61

Извлекает заголовок, используемый для идентификации пользователя на прокси-сервере, который требует проверки подлинности. Этот заголовок можно получить только до отправки запроса на сервер.

HTTP_QUERY_PROXY_CONNECTION

69

Извлекает заголовок Proxy-Connection.

HTTP_QUERY_PUBLIC

8

Получает методы, доступные на этом сервере.

HTTP_QUERY_RANGE

62

Извлекает диапазон байтов сущности.

HTTP_QUERY_RAW_HEADERS

21

Получает все заголовки, возвращенные сервером. Каждый заголовок завершается "\0". Дополнительный "\0" завершает список заголовков.

HTTP_QUERY_RAW_HEADERS_CRLF

22

Получает все заголовки, возвращенные сервером. Каждый заголовок отделяется последовательностью возврата каретки или канала строки (CR/LF).

HTTP_QUERY_REFERER

35

Получает универсальный код ресурса (URI) ресурса, в котором был получен запрошенный URI.

HTTP_QUERY_REFRESH

46

Является устаревшей. Поддерживается только для обеспечения совместимости устаревших приложений.

HTTP_QUERY_REQUEST_METHOD

45

Получает HTTP-команду, используемую в запросе, обычно GET или POST.

HTTP_QUERY_RETRY_AFTER

36

Извлекает время, в течение которого служба должна быть недоступна.

HTTP_QUERY_SERVER

37

Извлекает данные о программном обеспечении, используемом сервером-источником для обработки запроса.

HTTP_QUERY_SET_COOKIE

43

Получает значение файла cookie, заданного для запроса.

HTTP_QUERY_STATUS_CODE

19

Получает код состояния, возвращенный сервером. Дополнительные сведения и список возможных значений см. в разделе Коды состояния HTTP.

HTTP_QUERY_STATUS_TEXT

20

Получает любой дополнительный текст, возвращаемый сервером в строке ответа.

HTTP_QUERY_TITLE

38

Является устаревшей. Поддерживается только для обеспечения совместимости устаревших приложений.

HTTP_QUERY_TRANSFER_ENCODING

63

Извлекает тип преобразования, примененного к тексту сообщения, чтобы его можно было безопасно передать между отправителем и получателем.

HTTP_QUERY_UNLESS_MODIFIED_SINCE

70

Извлекает заголовок Unless-Modified-Since.

HTTP_QUERY_UPGRADE

64

Извлекает дополнительные протоколы связи, поддерживаемые сервером.

HTTP_QUERY_URI

13

Получает некоторые или все универсальные идентификаторы ресурсов (URI), с помощью которых можно идентифицировать ресурс Request-URI.

HTTP_QUERY_USER_AGENT

39

Извлекает данные об агенте пользователя, который сделал запрос.

HTTP_QUERY_VARY

65

Извлекает заголовок, указывающий, что сущность была выбрана из ряда доступных представлений ответа с использованием согласования на основе сервера.

HTTP_QUERY_VERSION

18

Получает последний код ответа, возвращенный сервером.

HTTP_QUERY_VIA

66

Извлекает промежуточные протоколы и получателей между агентом пользователя и сервером в запросах, а также между сервером-источником и клиентом в ответах.

HTTP_QUERY_WARNING

67

Извлекает дополнительные данные о состоянии ответа, которые могут не отражаться в коде состояния ответа.

HTTP_QUERY_WWW_AUTHENTICATE

40

Извлекает схему проверки подлинности и область, возвращенные сервером.

HTTP_QUERY_X_CONTENT_TYPE_OPTIONS

79

Извлекает значение заголовка X-Content-Type-Options.

HTTP_QUERY_P3P

80

Извлекает значение заголовка P3P.

HTTP_QUERY_X_P2P_PEERDIST

81

Извлекает значение заголовка X-P2P-PeerDist.

HTTP_QUERY_TRANSLATE

82

Извлекает значение заголовка перевода.

HTTP_QUERY_X_UA_COMPATIBLE

83

Извлекает значение заголовка X-UA-Compatible.

HTTP_QUERY_DEFAULT_STYLE

84

Извлекает значение заголовка Default-Style.

HTTP_QUERY_X_FRAME_OPTIONS

85

Извлекает значение заголовка X-Frame-Options.

HTTP_QUERY_X_XSS_PROTECTION

86

Извлекает значение заголовка X-XSS-Protection.

Флаги модификаторов используются в сочетании с флагом атрибута для изменения запроса. Флаги-модификаторы либо изменяют формат возвращаемых данных, либо указывают, где HttpQueryInfo (или QueryInfo) должен искать данные.

HTTP_QUERY_FLAG_COALESCE

0x10000000

Не реализован.

HTTP_QUERY_FLAG_NUMBER

0x20000000

Возвращает данные в виде 32-разрядного числа для заголовков, значением которых является число, например код состояния.

HTTP_QUERY_FLAG_REQUEST_HEADERS

0x80000000

Запрашивает только заголовки запросов.

HTTP_QUERY_FLAG_SYSTEMTIME

0x40000000

Возвращает значение заголовка в виде структуры SYSTEMTIME , которая не требует от приложения синтаксического анализа данных. Используется для заголовков, значением которых является строка даты и времени, например "Время последнего изменения".

Комментарии

Примечание

WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Wininet.h