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

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

Перечисление WinHttpRequestOption включает параметры, которые можно задать или извлечь для текущего сеанса Microsoft Windows HTTP Services (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

Извлекает ВАРИАНТ , содержащий 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_TRUE , чтобы указать, что запросы автоматически перенаправляются.

WinHttpRequestOption_UrlEscapeDisable

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

WinHttpRequestOption_UrlEscapeDisableQuery

Задает или извлекает ВАРИАНТ , указывающий, преобразуются ли небезопасные символы в компоненте запроса 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 см. в разделе "Требования кRun-Time " начальной страницы WinHttp.

Требования

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

См. также

Версии WinHTTP

  • Last updated on