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

Эти атрибуты и модификаторы используются WinHttpQueryHeaders.

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

WINHTTP_QUERY_ACCEPT

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

WINHTTP_QUERY_ACCEPT_CHARSET

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

WINHTTP_QUERY_ACCEPT_ENCODING

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

WINHTTP_QUERY_ACCEPT_LANGUAGE

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

WINHTTP_QUERY_ACCEPT_RANGES

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

WINHTTP_QUERY_AGE

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

WINHTTP_QUERY_ALLOW

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

WINHTTP_QUERY_AUTHENTICATION_INFO

Извлекает заголовок Authentication-Info.

WINHTTP_QUERY_AUTHORIZATION

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

WINHTTP_QUERY_CACHE_CONTROL

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

WINHTTP_QUERY_CONNECTION

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

WINHTTP_QUERY_CONTENT_BASE

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

WINHTTP_QUERY_CONTENT_DESCRIPTION

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

WINHTTP_QUERY_CONTENT_DISPOSITION

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

WINHTTP_QUERY_CONTENT_ENCODING

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

WINHTTP_QUERY_CONTENT_ID

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

WINHTTP_QUERY_CONTENT_LANGUAGE

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

WINHTTP_QUERY_CONTENT_LENGTH

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

WINHTTP_QUERY_CONTENT_LOCATION

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

WINHTTP_QUERY_CONTENT_MD5

Извлекает хэш MD5 тела сущности с целью обеспечения сквозной проверки целостности сообщения для тела сущности. Дополнительные сведения см. в статье RFC 1864.

WINHTTP_QUERY_CONTENT_RANGE

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

WINHTTP_QUERY_CONTENT_TRANSFER_ENCODING

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

WINHTTP_QUERY_CONTENT_TYPE

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

WINHTTP_QUERY_COOKIE

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

WINHTTP_QUERY_COST

Не поддерживается.

WINHTTP_QUERY_CUSTOM

Заставляет WinHttpQueryHeaders искать имя заголовка, указанное в параметре pwszName , и сохранять сведения о заголовке в lpBuffer. Приложение может использовать WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT , чтобы ограничить максимальное время ожидания запроса для получения всех заголовков.

WINHTTP_QUERY_DATE

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

WINHTTP_QUERY_DERIVED_FROM

Не поддерживается.

WINHTTP_QUERY_ETAG

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

WINHTTP_QUERY_EXPECT

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

WINHTTP_QUERY_EXPIRES

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

WINHTTP_QUERY_FORWARDED

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

WINHTTP_QUERY_FROM

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

WINHTTP_QUERY_HOST

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

WINHTTP_QUERY_IF_MATCH

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

WINHTTP_QUERY_IF_MODIFIED_SINCE

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

WINHTTP_QUERY_IF_NONE_MATCH

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

WINHTTP_QUERY_IF_RANGE

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

WINHTTP_QUERY_IF_UNMODIFIED_SINCE

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

WINHTTP_QUERY_LINK

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

WINHTTP_QUERY_LAST_MODIFIED

Получает дату и время последнего изменения ресурса. Дата и время определяются сервером.

WINHTTP_QUERY_LOCATION

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

WINHTTP_QUERY_MAX

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

WINHTTP_QUERY_MAX_FORWARDS

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

WINHTTP_QUERY_MESSAGE_ID

Не поддерживается.

WINHTTP_QUERY_MIME_VERSION

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

WINHTTP_QUERY_ORIG_URI

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

WINHTTP_QUERY_PRAGMA

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

WINHTTP_QUERY_PROXY_AUTHENTICATE

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

WINHTTP_QUERY_PROXY_AUTHORIZATION

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

WINHTTP_QUERY_PROXY_CONNECTION

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

WINHTTP_QUERY_PROXY_SUPPORT

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

WINHTTP_QUERY_PUBLIC

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

WINHTTP_QUERY_RANGE

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

WINHTTP_QUERY_RAW_HEADERS

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

WINHTTP_QUERY_RAW_HEADERS_CRLF

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

WINHTTP_QUERY_REFERER

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

WINHTTP_QUERY_REFRESH

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

WINHTTP_QUERY_REQUEST_METHOD

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

WINHTTP_QUERY_RETRY_AFTER

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

WINHTTP_QUERY_SERVER

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

WINHTTP_QUERY_SET_COOKIE

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

WINHTTP_QUERY_STATUS_CODE

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

WINHTTP_QUERY_STATUS_TEXT

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

WINHTTP_QUERY_TITLE

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

WINHTTP_QUERY_TRANSFER_ENCODING

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

WINHTTP_QUERY_UNLESS_MODIFIED_SINCE

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

WINHTTP_QUERY_UPGRADE

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

WINHTTP_QUERY_URI

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

WINHTTP_QUERY_USER_AGENT

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

WINHTTP_QUERY_VARY

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

WINHTTP_QUERY_VERSION

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

WINHTTP_QUERY_VIA

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

WINHTTP_QUERY_WARNING

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

WINHTTP_QUERY_WWW_AUTHENTICATE

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

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

WINHTTP_QUERY_FLAG_NUMBER

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

WINHTTP_QUERY_FLAG_REQUEST_HEADERS

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

WINHTTP_QUERY_FLAG_SYSTEMTIME

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

WINHTTP_QUERY_FLAG_TRAILERS

Представлено в Windows 11 версии 21H2 (10.0; Сборка 22000). Запросы трейлеров ответов. Прежде чем отправлять запросы к трейлерам ответов, необходимо вызывать WinHttpReadData , пока не будет возвращено прочитано 0 байтов.

WINHTTP_QUERY_FLAG_WIRE_ENCODING

Представлено в Windows 11 версии 21H2 (10.0; Сборка 22000). По умолчанию WinHttpQueryHeaders выполняет преобразование Юникода перед возвратом запрошенного заголовка. Если этот флаг установлен, WinHttp возвращает заголовок вызывающей объекту без выполнения этого преобразования.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Заголовок	Winhttp.h

См. также раздел

• Версии WinHTTP