Поделиться через

Перечисление WinHttpRequestOption

  • Статья

Перечисление WinHttpRequestOption включает параметры, которые можно задать или получить для текущего сеанса Служб Microsoft Windows HTTP (WinHTTP).

Синтаксис

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

Константы

WinHttpRequestOption_UserAgentString

Задает или извлекает variant , содержащий строку агента пользователя .

WinHttpRequestOption_URL

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

WinHttpRequestOption_URLCodePage

Задает или извлекает объект VARIANT , определяющий кодовую страницу для строки URL-адреса. Значением по умолчанию является кодовая страница UTF-8. Кодовая страница используется для преобразования строки URL-адреса Юникода, переданной в методе Open , в однобайтовое строковое представление.

WinHttpRequestOption_EscapePercentInURL

Задает или извлекает значение VARIANT , указывающее, преобразуется ли процент символов в строке URL-адреса в escape-последовательность. Значение этого параметра по умолчанию — VARIANT_TRUE который указывает, что все небезопасные символы Американского национального института стандартов (ANSI), за исключением символа процента, преобразуются в escape-последовательность.

WinHttpRequestOption_SslErrorIgnoreFlags

Задает или извлекает значение VARIANT , указывающее, какие ошибки сертификата сервера следует игнорировать. Это может быть сочетание одного или нескольких следующих флагов.

Ошибка Значение
Неизвестный центр сертификации (ЦС) или ненадежный корень 0x0100
Неправильное использование 0x0200
Недопустимое общее имя (CN) 0x1000
Недопустимая дата или срок действия сертификата 0x2000

Значение этого параметра по умолчанию в версии 5.1 WinHTTP равно нулю, что не приводит к игнорированию ошибок. В более ранних версиях WinHTTP значение по умолчанию было 0x3300, что приводило к тому, что по умолчанию все ошибки сертификата сервера игнорирулись.

WinHttpRequestOption_SelectCertificate

Задает variant , указывающий сертификат клиента, отправляемый серверу для проверки подлинности. Этот параметр указывает расположение, хранилище сертификатов и субъект сертификата клиента с разделителями обратной косой чертой. Дополнительные сведения о выборе сертификата клиента см. в разделе SSL в WinHTTP.

WinHttpRequestOption_EnableRedirects

Задает или извлекает variant , указывающий, будут ли запросы автоматически перенаправляться, когда сервер указывает новое расположение ресурса. Значение этого параметра по умолчанию — VARIANT_TRUE , чтобы указать, что запросы перенаправляются автоматически.

WinHttpRequestOption_UrlEscapeDisable

Задает или извлекает значение VARIANT , указывающее, преобразуются ли небезопасные символы в компонентах пути и запроса URL-адреса в escape-последовательности. Значение этого параметра по умолчанию — VARIANT_TRUE, указывающее, что символы в пути и запросе преобразуются.

WinHttpRequestOption_UrlEscapeDisableQuery

Задает или извлекает значение VARIANT , указывающее, преобразуются ли небезопасные символы в компоненте запроса URL-адреса в escape-последовательности. Значение этого параметра по умолчанию — VARIANT_TRUE, указывающее, что символы в запросе преобразуются.

WinHttpRequestOption_SecureProtocols

Задает или извлекает variant , указывающий, какие безопасные протоколы можно использовать. Этот параметр выбирает протоколы, приемлемые для клиента. Протокол согласовывается во время подтверждения SSL. Это может быть сочетание одного или нескольких следующих флагов.

Протокол Значение
SSL 2.0 0x0008
SSL 3.0 0x0020
Tls 1.0 0x0080

Значение этого параметра по умолчанию — 0x0028, что означает, что можно использовать SSL 2.0 или SSL 3.0. Если этот параметр равен нулю, клиент и сервер не могут определить приемлемый протокол безопасности, а следующая отправка приведет к ошибке.

WinHttpRequestOption_EnableTracing

Задает или извлекает значение VARIANT , указывающее, включена ли трассировка в данный момент. См. также раздел Сбор трассировок WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Определяет, временно ли объект WinHttpRequest отменяет олицетворение клиента на время выполнения операций проверки подлинности SSL-сертификата. По умолчанию для объекта WinHttpRequest задано значение TRUE. Установите для этого параметра значение FALSE , чтобы сохранить олицетворение при выполнении операций проверки подлинности сертификата.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Определяет, разрешает ли WinHTTP перенаправления. По умолчанию автоматически отслеживаются все перенаправления, за исключением тех, которые передаются с защищенного URL-адреса (https) на небезопасный URL-адрес (HTTP). Установите для этого параметра значение TRUE , чтобы включить перенаправления HTTPS на HTTP.

WinHttpRequestOption_EnablePassportAuthentication

Включает или отключает поддержку проверки подлинности Passport. По умолчанию автоматическая поддержка проверки подлинности Passport отключена; Установите для этого параметра значение TRUE , чтобы включить поддержку проверки подлинности Passport.

WinHttpRequestOption_MaxAutomaticRedirects

Задает или извлекает максимальное количество перенаправлений, за которыми следует WinHTTP; значение по умолчанию — 10. Это ограничение не позволяет несанкционированным сайтам остановить клиент WinHTTP после большого количества перенаправлений.

Windows XP с пакетом обновления 1 (SP1) и Windows 2000 с пакетом обновления 3 (SP3): Это значение перечисления не поддерживается.

WinHttpRequestOption_MaxResponseHeaderSize

Задает или извлекает привязанный набор для максимального размера части заголовка ответа сервера. Эта привязка защищает клиента от вредоносного сервера, пытающегося остановить клиента, отправляя ответ с бесконечным объемом данных заголовка. Значение по умолчанию — 64 КБ.

Windows XP с пакетом обновления 1 (SP1) и Windows 2000 с пакетом обновления 3 (SP3): Это значение перечисления не поддерживается.

WinHttpRequestOption_MaxResponseDrainSize

Задает или извлекает привязку к объему данных, которые будут удалены из ответов для повторного использования подключения. По умолчанию установлено значение 1 МБ.

Windows XP с пакетом обновления 1 (SP1) и Windows 2000 с пакетом обновления 3 (SP3): Это значение перечисления не поддерживается.

WinHttpRequestOption_EnableHttp1_1

Задает или извлекает логическое значение, указывающее, следует ли использовать HTTP/1.1 или HTTP/1.0. Значение по умолчанию — TRUE, поэтому по умолчанию используется HTTP/1.1.

Windows XP с пакетом обновления 1 (SP1) и Windows 2000 с пакетом обновления 3 (SP3): Это значение перечисления не поддерживается.

WinHttpRequestOption_EnableCertificateRevocationCheck

Включает проверку отзыва сертификатов сервера во время согласования SSL. Когда сервер представляет сертификат, выполняется проверка, чтобы определить, был ли сертификат отозван его издателем. Если сертификат действительно отозван или проверка отзыва завершается сбоем, так как не удается скачать список отзыва сертификатов (CRL), запрос завершается ошибкой; такие ошибки отзыва не могут быть подавлены.

Windows XP с пакетом обновления 1 (SP1) и Windows 2000 с пакетом обновления 3 (SP3): Это значение перечисления не поддерживается.

Комментарии

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

Примечание

Для Windows XP и Windows 2000 см. раздел Требования к времени выполнения начальной страницы WinHttp.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера
 Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Распространяемые компоненты
 WinHTTP 5.0 и Internet Обозреватель 5.01 или более поздней версии в Windows XP и Windows 2000.
IDL
HttpRequest.idl

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

Версии WinHTTP