Флаги параметров
Следующие флаги параметров поддерживаются WinHttpQueryOption и WinHttpSetOption.
WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS
Значение по умолчанию — FALSE. Если задано значение TRUE, WinHTTP не гарантирует ход выполнения, если обратные вызовы состояния блокируются клиентским приложением.
Клиентское приложение должно проявлять особую осторожность, чтобы выполнять минимальные операции в рамках обратного вызова без блокировки, возвращая как можно быстрее, и, в частности, не должно ждать каких-либо последующих вызовов WinHTTP. Если они не соответствуют этим рекомендациям, скорее всего, это негативно скажется на производительности или может зависнуть приложение. При использовании в установленном порядке этот параметр может повысить производительность.
WINHTTP_OPTION_AUTOLOGON_POLICY
Задает длинное целое число без знака, указывающее политику автоматического входа с одним из следующих значений.
| Термин | Описание |
|---|---|
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH | Учетные данные по умолчанию не используются. Обратите внимание, что этот флаг вступает в силу, только если вы указываете сервер по фактическому имени компьютера. Он не вступит в силу, если указать сервер по "localhost" или IP-адресу. |
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW | Вход с проверкой подлинности с использованием учетных данных по умолчанию выполняется для всех запросов. |
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM | Вход с проверкой подлинности с использованием учетных данных по умолчанию выполняется только для запросов в локальной интрасети. |
WINHTTP_OPTION_BACKGROUND_CONNECTIONS
При установке этого параметра для дескриптора сеанса необходимо передать количество подключений, которые вы хотите открыть. Затем, после первой отправки запроса, вместо того чтобы открывать только одно подключение, WinHttp открывает несколько подключений в параллельном режиме. Это может повысить производительность последующих запросов к тому же назначению, что не приведет к дополнительным затратам на установление подключения.
WINHTTP_OPTION_CALLBACK
Извлекает указатель на набор функций обратного вызова с winHttpSetStatusCallback.
WINHTTP_OPTION_CLIENT_CERT_CONTEXT
Задает контекст сертификата клиента. Если приложение получает ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED, оно должно вызвать WinHttpSetOption , чтобы предоставить сертификат, прежде чем повторить запрос. В рамках обработки этого параметра WinHttp вызывает CertDuplicateCertificateContext в контексте сертификата, предоставленном вызывающим объектом, чтобы контекст сертификата можно было независимо освободить.
Примечание
Приложение не должно пытаться закрыть хранилище сертификатов с флагом CERT_CLOSE_STORE_FORCE_FLAG в вызове CertCloseStore в хранилище сертификатов, из которого был получен контекст сертификата. Может произойти нарушение доступа.
Когда сервер запрашивает сертификат клиента, WinHttpSendRequest или WinHttpReceiveResponse возвращает ошибку ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED . Если сервер запрашивает сертификат, но не требует его, приложение может указать этот параметр, чтобы указать, что у него нет сертификата. Сервер может выбрать другую схему проверки подлинности или разрешить анонимный доступ к серверу. Приложение предоставляет макрос WINHTTP_NO_CLIENT_CERT_CONTEXT в параметре lpBufferwinHttpSetOption , как показано в следующем примере кода.
BOOL fRet = WinHttpSetOption(hRequest,
WINHTTP_OPTION_CLIENT_CERT_CONTEXT,
WINHTTP_NO_CLIENT_CERT_CONTEXT,
0);
Если серверу требуется сертификат клиента, он может отправить в ответ код состояния HTTP 403. Дополнительные сведения см. в разделе параметр WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST .
WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST
Извлекает структуру SecPkgContext_IssuerListInfoEx , если ошибка из WinHttpSendRequest или WinHttpReceiveResponseERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED. Список издателей в структуре содержит список допустимых центров сертификации (ЦС) с сервера. Клиентское приложение может отфильтровать список ЦС, чтобы получить сертификат клиента для проверки подлинности SSL.
Кроме того, если сервер запрашивает сертификат клиента, но не требует его, приложение может вызвать WinHttpSetOption с параметром WINHTTP_OPTION_CLIENT_CERT_CONTEXT . Дополнительные сведения см. в разделе параметр WINHTTP_OPTION_CLIENT_CERT_CONTEXT .
WINHTTP_OPTION_CODEPAGE
Задает кодовую страницу , используемую для обработки URL-адреса (то есть строки запроса). По умолчанию используется значение UTF8.
WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH
Задает длинное целое число без знака, указывающее, включена ли проверка подлинности passport в WinHTTP . Он может иметь одно из следующих значений:
| Термин | Описание |
|---|---|
| WINHTTP_DISABLE_PASSPORT_AUTH | Проверка подлинности Microsoft Passport отключена. Это значение по умолчанию. |
| WINHTTP_DISABLE_PASSPORT_KEYRING | Ключи passport отключены. Это значение по умолчанию. |
| WINHTTP_ENABLE_PASSPORT_AUTH | Включена проверка подлинности по паспорту. |
| WINHTTP_ENABLE_PASSPORT_KEYRING | Функция keyring passport включена. |
WINHTTP_OPTION_CONNECT_RETRIES
Задает или извлекает длинное целое число без знака, содержащее количество попыток подключенияWinHTTP к узлу. Http Services Microsoft Windows (WinHTTP) выполняет попытки только один раз для каждого IP-адреса. Например, если вы пытаетесь подключиться к узлу с несколькими адресами с 10 IP-адресами и WINHTTP_OPTION_CONNECT_RETRIES имеет значение 7, WinHTTP попытается подключиться только к первым семи IP-адресам. При том же наборе из 10 IP-адресов, если WINHTTP_OPTION_CONNECT_RETRIES имеет значение 20, WinHTTP пытается каждый из 10 только один раз. Если попытка подключения по-прежнему завершается сбоем после указанного количества попыток или время ожидания подключения истекло до этого времени, запрос отменяется. Значение по умолчанию для WINHTTP_OPTION_CONNECT_RETRIES — пять попыток.
WINHTTP_OPTION_CONNECT_TIMEOUT
Задает или извлекает длинное целое число без знака, содержащее значение времени ожидания в миллисекундах. Если задать для этого параметра значение infinite (0xFFFFFFFF), этот таймер будет отключен.
Если запрос tcp-подключения занимает больше времени, чем это значение времени ожидания, запрос отменяется. Время ожидания по умолчанию составляет 60 секунд. При попытке подключения к нескольким IP-адресам для одного узла (многосетвого узла) ограничение времени ожидания для каждого отдельного подключения.
WINHTTP_OPTION_CONNECTION_INFO
Извлекает исходный и целевой IP-адрес, а также порт запроса, который создал ответ при возврате WinHttpReceiveResponse . Приложение вызывает WinHttpQueryOption с параметром WINHTTP_OPTION_CONNECTION_INFO и предоставляет структуру WINHTTP_CONNECTION_INFO в параметре lpBuffer . Дополнительные сведения см. в разделе WINHTTP_CONNECTION_INFO.
Применимо к: Windows XP с пакетом обновления 2 (SP2) и более поздних версий; Windows 2003 с пакетом обновления 1 (SP1) и более поздних версий.
WINHTTP_OPTION_CONNECTION_GUID
Пометьте подключение, связанное с дескриптором запроса WinHTTP, с помощью GUID. Это позволяет пользовательский контроль над тем, какие запросы используют группы соединений с параметром WINHTTP_OPTION_MATCH_CONNECTION_GUID .
WINHTTP_OPTION_CONNECTION_STATS_V0
Возвращает структуру TCP_INFO_v0 для базового подключения, используемого запросом. Возвращаемая структура может содержать статистику из предыдущих запросов, отправленных через то же подключение.
Примечание
Этот параметр заменен WINHTTP_OPTION_CONNECTION_STATS_V1.
WINHTTP_OPTION_CONNECTION_STATS_V1
Возвращает структуру TCP_INFO_v1 для базового подключения, используемого запросом. Возвращаемая структура может содержать статистику из предыдущих запросов, отправленных через то же подключение.
WINHTTP_OPTION_CONTEXT_VALUE
Задает или извлекает DWORD_PTR , содержащий указатель на значение контекста, связанное с этим дескриптором HINTERNET . Используется значение, хранящееся в буфере, и флагу параметра WINHTTP_OPTION_CONTEXT_VALUE присваивается новое значение.
WINHTTP_OPTION_DECOMPRESSION
Задает DWORD флагов, определяющих, будет ли WinHTTP автоматически распаковывать тела ответов сжатыми кодированием содержимого. WinHTTP также установит соответствующий заголовок Accept-Encoding, переопределяя все, предоставленные вызывающим элементом. Поддерживаются значения:
| Термин | Описание |
|---|---|
| WINHTTP_DECOMPRESSION_FLAG_GZIP | Распаковка кодирования содержимого: ответы gzip. |
| WINHTTP_DECOMPRESSION_FLAG_DEFLATE | Распаковка кодирования содержимого: отмена ответов. |
| WINHTTP_DECOMPRESSION_FLAG_ALL | Распаковка ответов с любым поддерживаемым кодированием содержимого. |
По умолчанию WinHTTP будет доставлять сжатые ответы вызывающей объекту без изменений.
WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING
Установка этого параметра для дескриптора сеанса WinHttp позволяет включать и отключать создание цепочки сертификатов сервера.
WINHTTP_OPTION_DISABLE_FEATURE
Задает длинное целое число без знака, указывающее, какие функции отключены с помощью одного или нескольких следующих флагов. Имейте в виду, что эта функция должна передаваться в WinHttpSetOption только для дескрипторов запросов после создания дескриптора запроса с помощью WinHttpOpenRequest и перед отправкой запроса с помощью WinHttpSendRequest.
| Термин | Описание |
|---|---|
| WINHTTP_DISABLE_AUTHENTICATION | Автоматическая проверка подлинности отключена. |
| WINHTTP_DISABLE_COOKIES | Автоматическое добавление заголовков файлов cookie в запросы отключено. Кроме того, возвращенные файлы cookie не добавляются автоматически в базу данных файлов cookie. Отключение файлов cookie может привести к снижению производительности проверки подлинности Passport. |
| WINHTTP_DISABLE_KEEP_ALIVE | Отключает семантику поддержания активности для соединения. Семантика поддержания активности необходима для проверки подлинности MSN, NTLM и других типов проверки подлинности. |
| WINHTTP_DISABLE_REDIRECTS | Автоматическое перенаправление отключено при отправке запросов с помощью WinHttpSendRequest. Если автоматическое перенаправление отключено, приложение должно зарегистрировать функцию обратного вызова для успешной проверки подлинности Passport. |
WINHTTP_OPTION_DISABLE_GLOBAL_POOLING
Отключает глобальные межсеансовые пулы. Это рекомендуемая практика, так как глобальный межсеансовый пул — это устаревшее поведение, которое поддерживается по умолчанию для обеспечения совместимости. На это влияет последующее задание максимального количества подключений вручную.
WINHTTP_OPTION_DISABLE_PROXY_AUTH_SCHEMES
Отключает одну или несколько следующих методик проверки подлинности прокси-сервера в сеансе WinHTTP, предоставляя OR все применимые варианты. Это все схемы, за исключением WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE, которые принудительно используют учетную запись локального компьютера при отправке запросов на замыкания на себя или локальный адрес. Это предотвращает утечку системных учетных данных в локальные прокси-серверы HTTP.
| Термин | Описание |
|---|---|
| WINHTTP_PROXY_DISABLE_SCHEME_BASIC | Отключает обычную схему проверки подлинности. |
| WINHTTP_PROXY_DISABLE_SCHEME_DIGEST | Отключает схему дайджест-проверки подлинности. |
| WINHTTP_PROXY_DISABLE_SCHEME_NTLM | Отключает схему проверки подлинности NTLM. |
| WINHTTP_PROXY_DISABLE_SCHEME_KERBEROS | Отключает схему проверки подлинности Kerberos. |
| WINHTTP_PROXY_DISABLE_SCHEME_NEGOTIATE | Отключает схему проверки подлинности Negotiate. |
| WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE | Принудительно использует учетную запись локального компьютера при отправке запросов на замыкания на себя или локальный адрес. |
WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK
Запрещает WinHTTP повторить подключение с более ранней версией протокола безопасности при сбое первоначального согласования протокола.
WINHTTP_OPTION_DISABLE_STREAM_QUEUE
Позволяет новым запросам открывать дополнительное подключение HTTP/2 при достижении максимального количества одновременных потоков, а не ожидать следующего доступного потока для существующего подключения.
WINHTTP_OPTION_ENABLE_FEATURE
Задает длинное целочисленное значение без знака, указывающее включенные в данный момент функции. Может иметь одно из следующих значений.
| Термин | Описание |
|---|---|
| WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION | Если этот параметр включен, WinHTTP временно отменяет олицетворение клиента на время операций проверки подлинности SSL-сертификата. Это значение можно задать только для дескриптора сеанса. |
| WINHTTP_ENABLE_SSL_REVOCATION | Если этот параметр включен, WinHTTP разрешает отзыв SSL. Это значение можно задать только для дескриптора запроса. |
WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL
Задает битовую маску DWORD допустимых расширенных версий HTTP. Возможны следующие значения:
| Термин | Описание |
|---|---|
| WINHTTP_PROTOCOL_FLAG_HTTP2 (0x1) | Включает HTTP/2 для запроса. |
| WINHTTP_PROTOCOL_FLAG_HTTP3 (0x2) | Включает HTTP/3 для запроса. |
| Нет (0x0) | Ограничивает запрос http/1.1 и более предыдущими версиями. |
Устаревшие версии HTTP (1.1 и более ранние версии) нельзя отключить с помощью этого параметра. Значение по умолчанию — 0x0.
WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT
Этот параметр можно задать для дескриптора сеанса WinHttp, чтобы разрешить WinHttp использовать предоставленный вызывающим объектом контекст сертификата клиента при использовании HTTP/2.
WINHTTP_OPTION_ENABLETRACING
Задает значение BOOL , указывающее, включена ли трассировка в данный момент. Этот параметр можно задать только для дескриптора NULLHINTERNET . См. также раздел Сбор трассировок WinHTTP.
WINHTTP_OPTION_ENCODE_EXTRA
Включает кодирование процента URL-адресов для пути и строки запроса.
Кроме того, можно закодировать процент перед вызовом WinHttp.
WINHTTP_OPTION_EXPIRE_CONNECTION
Этот параметр можно задать только для дескриптора запроса, который по-прежнему активен (отправляющий или принимающий). Установка этого параметра позволит WinHttp прекратить обслуживание запросов на соединение, связанное с переданным дескриптором запроса. Соединение будет закрыто после завершения дескриптора запроса, вызываемого с помощью этого параметра. Этот параметр не принимает никаких параметров.
WINHTTP_OPTION_EXTENDED_ERROR
Извлекает длинное целочисленное значение без знака, содержащее код ошибки Microsoft Windows Sockets, сопоставленный с сообщениями об ошибках ERROR_WINHTTP_*, которые в последний раз возвращались в этом контексте потока. В качестве значения дескриптора можно передать null .
WINHTTP_OPTION_FEATURE_SUPPORTED
Проверьте, поддерживается ли указанный флаг параметра этой версией WinHTTP.
WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION
По умолчанию, когда WinHttp отправляет запрос, если нет доступных подключений для обслуживания запроса, WinHttp попытается установить новое подключение, и запрос будет привязан к этому новому подключению. При установке этого параметра такой запрос будет обслуживаться при первом подключении, которое становится доступным, и не обязательно устанавливается.
WINHTTP_OPTION_GLOBAL_PROXY_CREDS
Принимает указатель на структуру WINHTTP_CREDS_EX с параметром функции hInternet , имеющим значение NULL. Для этого параметра требуется раздел реестра HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Если этот раздел реестра не задан, WinHTTP вернет ошибку ERROR_WINHTTP_INVALID_OPTION. Этот раздел реестра отсутствует по умолчанию. Если он задан, WinINet отправит учетные данные в WinHTTP. Всякий раз, когда WinHttp получает запрос проверки подлинности, и если учетные данные не заданы для текущего дескриптора, он будет использовать учетные данные, предоставленные WinINet. Чтобы совместно использовать учетные данные сервера в дополнение к учетным данным прокси-сервера, пользователям необходимо задать WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .
WINHTTP_OPTION_GLOBAL_SERVER_CREDS
Принимает указатель на структуру WINHTTP_CREDS_EX с параметром функции hInternet , имеющим значение NULL. Для этого параметра требуется раздел реестра HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Если этот раздел реестра не задан, WinHTTP вернет ошибку ERROR_WINHTTP_INVALID_OPTION. Этот раздел реестра отсутствует по умолчанию. Если он задан, WinINet отправит учетные данные в WinHTTP. Всякий раз, когда WinHttp получает запрос проверки подлинности, и если учетные данные не заданы для текущего дескриптора, он будет использовать учетные данные, предоставленные WinINet. Чтобы совместно использовать учетные данные сервера в дополнение к учетным данным прокси-сервера, пользователям необходимо задать WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .
WINHTTP_OPTION_HANDLE_TYPE
Извлекает длинное целочисленное значение без знака, содержащее тип переданного дескриптора HINTERNET . Может возвращаться одно из следующих значений:
| Термин | Описание |
|---|---|
| WINHTTP_HANDLE_TYPE_CONNECT | Дескриптор является дескриптором подключения. |
| WINHTTP_HANDLE_TYPE_REQUEST | Дескриптор — это дескриптор запроса. |
| WINHTTP_HANDLE_TYPE_SESSION | Дескриптор является дескриптором сеанса. |
WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED
Запрещает использование для запроса версий протоколов, отличных от версий, включенных WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL .
WINHTTP_OPTION_HTTP_PROTOCOL_USED
Возвращает значение DWORD, указывающее, какая расширенная версия HTTP использовалась в данном запросе. Список возможных значений см. в разделе WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL.
WINHTTP_OPTION_HTTP_VERSION
Задает или извлекает структуру HTTP_VERSION_INFO , содержащую поддерживаемую версию HTTP. Это вариант для всего процесса; используйте значение NULL для дескриптора.
WINHTTP_OPTION_HTTP2_KEEPALIVE
Этот параметр можно задать для дескриптора сеанса, чтобы WinHttp использовал кадры PING HTTP/2 в качестве механизма сохранения. Вызывающие абоненты указывают время ожидания в миллисекундах, и после отсутствия активности подключения в течение этого периода времени ожидания WinHttp начнет отправлять кадры PING HTTP/2. Вызывающие абоненты не могут задать значение времени ожидания менее 5000 миллисекундах.
WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING
Этот параметр можно задать для дескриптора запроса WinHttp, чтобы управлять поведением WinHttp, если ответ HTTP/2 содержит заголовок "Transfer-Encoding". В этом случае WinHttp возвращает ошибку, если этот параметр имеет значение FALSE.
WINHTTP_OPTION_HTTP2_RECEIVE_WINDOW
Задайте исходный размер окна получения потока HTTP/2 и пороговое значение для отправки обновлений окна с помощью структуры WINHTTP_HTTP2_RECEIVE_WINDOW .
WINHTTP_OPTION_HTTP3_HANDSHAKE_TIMEOUT
Использует буфер, чтобы задать время ожидания подтверждения HTTP/3 в миллисекундах в качестве PDWORD.
WINHTTP_OPTION_HTTP3_INITIAL_RTT
Настраивает начальный RTT в миллисекундах, используемых msquic.
WINHTTP_OPTION_HTTP3_KEEPALIVE
Включает семантику поддержания активности для соединения. Использует буфер, чтобы задать время ожидания поддержания активности в миллисекундах в качестве PDWORD.
WINHTTP_OPTION_HTTP3_STREAM_ERROR_CODE
Извлекает предоставленную сервером ошибку в потоке HTTP/3, используемом для отправки запроса.
WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE
Позволяет безопасным подключениям использовать сертификаты безопасности, для которых не удалось скачать список отзыва сертификатов.
WINHTTP_OPTION_IPV6_FAST_FALLBACK
Включает быстрый резервный вариант IPv6 (Happier Eyeballs) для подключения. Это поведение похоже на поведение Happy Eyeballs, описанное в RFC 6555 для улучшения времени подключения в сетях, где IPv6 ненадежный.
- Если адреса IPv6 и IPv4 разрешены для данного узла, WinHttp начнет с подключения к первому разрешенным IPv6-адресу с коротким временем ожидания (300 мс).
- В случае сбоя подключения WinHttp попытается подключиться к первому разрешенным IPv4-адресу со стандартным временем ожидания.
- В случае сбоя второго подключения WinHttp повторит первый разрешенный IPv6-адрес со стандартным временем ожидания.
- В случае сбоя третьего подключения WinHttp будет отменить изменения к поведению по умолчанию для всех оставшихся адресов, пытаясь подключиться к каждому из них со стандартным временем ожидания, пока не будет установлено подключение или адреса не останутся.
WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE
Возвращает значение, указывающее, можно ли получить ответ прокси-сервера Return Connect.
WINHTTP_OPTION_MATCH_CONNECTION_GUID
Принимает структуру WINHTTP_MATCH_CONNECTION_GUID , чтобы сообщить WinHTTP об обслужить запрос для соответствующего подключения. Если задано WINHTTP_MATCH_CONNECTION_GUID_FLAG_REQUIRED , можно использовать только подключения с соответствующим ИДЕНТИФИКАТОРом GUID. В противном случае можно использовать подключения с соответствующими идентификаторами GUID и подключения, которые не помечены каким-либо ИДЕНТИФИКАТОРом GUID.
WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER
Задает или извлекает длинное целое число без знака, содержащее максимальное количество подключений, разрешенных для каждого сервера HTTP/1.0. Значение по умолчанию — INFINITE.
Применимо к: Windows Vista с пакетом обновления 1 (SP1) и более поздних версий; Windows Server 2008 и более поздних версий.
WINHTTP_OPTION_MAX_CONNS_PER_SERVER
Задает или извлекает длинное целое число без знака, содержащее максимальное количество подключений, разрешенных для каждого сервера. Значение по умолчанию — INFINITE.
Если этот параметр равен нулю, WinHTTP устанавливает ограничение на количество подключений равным 2.
WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS
Задает максимальное количество перенаправлений, за которыми следует WinHTTP; значение по умолчанию — 10. Это ограничение не позволяет несанкционированным сайтам приостановить работу клиента WinHTTP после большого количества перенаправлений.
Применимо к: Windows XP с пакетом обновления 1 (SP1) и более поздних версий; Windows 2000 с пакетом обновления 3 (SP3) и более поздних версий.
WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE
Максимальное число информационных ответов кода состояния 100–199, пропущенных перед возвратом окончательного кода состояния клиенту WinHTTP. Информационные коды состояния 100–199 могут быть отправлены сервером перед окончательным кодом состояния и описаны в спецификации для HTTP/1.1 (дополнительные сведения см. в разделе RFC 2616). Значение по умолчанию равно 10.
Применимо к: Windows XP с пакетом обновления 1 (SP1) и более поздних версий; Windows 2000 с пакетом обновления 3 (SP3) и более поздних версий.
WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE
Значение , привязанное к объему данных, осушенных из ответов для повторного использования соединения, указанного в байтах. Значение по умолчанию — 1 МБ.
Применимо к: Windows XP с пакетом обновления 1 (SP1) и более поздних версий; Windows 2000 с пакетом обновления 3 (SP3) и более поздних версий.
WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE
Привязанное значение для максимального размера части заголовка ответа сервера, указанного в байтах. Эта привязка защищает клиента от несанкционированного сервера, пытающегося остановить клиента, отправляя ответ с бесконечным объемом данных заголовка. Значение по умолчанию — 64 КБ.
Применимо к: Windows XP с пакетом обновления 1 (SP1) и более поздних версий; Windows 2000 с пакетом обновления 3 (SP3) и более поздних версий.
WINHTTP_OPTION_PARENT_HANDLE
Извлекает родительский дескриптор для этого дескриптора.
WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT
Извлекает строку, содержащую текст cobranding , предоставленный сервером входа Passport. Этот параметр следует получить сразу после ответа сервера входа в систему с кодом состояния 401. Приложение должно передавать буфер в байтах, который достаточно велик для хранения возвращаемой строки.
WINHTTP_OPTION_PASSPORT_COBRANDING_URL
Извлекает строку, содержащую URL-адрес для графического кобрендинга , предоставленного сервером входа в Passport. Этот параметр следует получить сразу после ответа сервера входа с кодом состояния 401. Приложение должно передавать буфер в байтах, который достаточно велик для хранения возвращаемой строки.
WINHTTP_OPTION_PASSPORT_RETURN_URL
Задает параметр только для чтения для дескриптора запроса, который получает URL-адрес возврата Passport.
WINHTTP_OPTION_PASSPORT_SIGN_OUT
Задает параметр для дескриптора сеанса для выхода из любых имен входа Passport. Приложение должно передать ВОЗВРАЩАемый URL-адрес Passport, полученный с помощью WINHTTP_OPTION_PASSPORT_RETURN_URL. Все файлы cookie, связанные с URL-адресом возврата, очищаются.
WINHTTP_OPTION_PASSWORD
Задает или извлекает строковое значение, содержащее пароль, связанный с дескриптором запроса.
WINHTTP_OPTION_PROXY
Задает или извлекает структуру WINHTTP_PROXY_INFO , которая содержит данные прокси-сервера для существующего дескриптора сеанса или дескриптора запроса. При получении данных прокси-сервера приложение должно освободить строки lpszProxy и lpszProxyBypass , содержащиеся в этой структуре (если они не имеют значение NULL), с помощью функции GlobalFree . Приложение может запрашивать данные глобального прокси-сервера (прокси-сервер по умолчанию), передав дескриптор NULL .
WINHTTP_OPTION_PROXY_PASSWORD
Задает или получает строковое значение, содержащее пароль, используемый для доступа к прокси-серверу.
WINHTTP_OPTION_PROXY_SPN_USED
Возвращает имя участника прокси-сервера, которое WinHTTP предоставил SSPI во время проверки подлинности. Это строковое значение используется для передачи в SspiPromptForCredentials после сбоя проверки подлинности.
WINHTTP_OPTION_PROXY_USERNAME
Задает или извлекает строковое значение, содержащее имя пользователя, используемое для доступа к прокси-серверу.
WINHTTP_OPTION_QUIC_STATS
Извлекает структуру QUIC_STATISTICS , содержащую сведения о подключении, такие как RTT и отправленные и полученные байты.
WINHTTP_OPTION_READ_BUFFER_SIZE
Этот параметр является нерекомендуемой; она не оказывает никакого влияния.
WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE
Задает возможность извлечения сущности ответа прокси-сервера. Этот параметр по умолчанию отключен.
WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT
Задает или извлекает длинное целочисленное значение без знака, содержащее значение времени ожидания (в миллисекундах) для ожидания получения всех заголовков ответа на запрос. Если WinHTTP не получает все заголовки в течение этого периода ожидания, запрос отменяется. Значение времени ожидания по умолчанию — 90 секунд.
Это время ожидания проверяется только при получении данных из сокета. В результате по истечении времени ожидания клиентское приложение не получает уведомления до получения дополнительных данных с сервера. Если данные не поступают с сервера, задержка между истечением времени ожидания и уведомлением клиентского приложения может быть равной значению времени ожидания, заданному с помощью параметра dwReceiveTimeout функции WinHttpSetTimeouts .
WINHTTP_OPTION_RECEIVE_TIMEOUT
Задает или извлекает длинное целочисленное значение без знака, содержащее значение времени ожидания в миллисекундах, чтобы получить частичный ответ на запрос или прочитать некоторые данные. Если ответ занимает больше времени ожидания, запрос отменяется. По умолчанию время ожидания составляет 30 секунд.
WINHTTP_OPTION_REDIRECT_POLICY
Задает поведение WinHTTP в отношении обработки 30-кратного кода состояния перенаправления HTTP. Этот параметр можно задать для сеанса или дескриптора запроса одно из следующих значений:
| Термин | Описание |
|---|---|
| WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS | Все перенаправления отслеживаются автоматически. |
| WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP | Выполняются все перенаправления, за исключением тех, которые исходят из безопасного URL-адреса (https) на небезопасный URL-адрес (HTTP). Это параметр по умолчанию. |
| WINHTTP_OPTION_REDIRECT_POLICY_NEVER | Перенаправления никогда не отслеживаются. 30-кратное состояние возвращается приложению. |
WINHTTP_OPTION_REJECT_USERPWD_IN_URL
Отклоняет URL-адреса, содержащие имя пользователя и пароль. Этот параметр также отклоняет URL-адреса, содержащие семантику username:password , даже если имя пользователя или пароль не указаны. Например, "u:p@hostname", ":@hostname", "u:@hostname" и ":p@hostname" будут помечены как недопустимые. Если в функцию передается недопустимый URL-адрес, она возвращает ERROR_WINHTTP_INVALID_URL. По умолчанию этот параметр выключен.
WINHTTP_OPTION_REQUEST_ANNOTATION
Включает получение и задание заметки запроса для предоставленного имени заметки. Это позволяет вызывающему объекту прикрепить строку к запросу для последующего получения, чтобы идентифицировать запросы с помощью любой пользовательской логики, которую вызывающий объект считает полезным.
WINHTTP_OPTION_REQUEST_PRIORITY
Этот параметр является нерекомендуемой; она не оказывает никакого влияния.
WINHTTP_OPTION_REQUEST_STATS
Возвращает статистику для запроса. Список доступных статистических данных см . в разделе WINHTTP_REQUEST_STATS.
WINHTTP_OPTION_REQUEST_TIMES
Возвращает сведения о времени для запроса. Список доступных временных интервалов см. в разделе WINHTTP_REQUEST_TIMES.
WINHTTP_OPTION_REQUIRE_STREAM_END
Этот параметр предписывает WinHttp игнорировать заголовки ответа Content-Length и продолжать получать данные в потоке, пока не будет получен флаг END_STREAM.
WINHTTP_OPTION_RESOLUTION_HOSTNAME
Этот параметр можно задать для дескриптора запроса WinHttp до его отправки. Если этот параметр задан, WinHttp будет использовать строку, предоставленную вызывающим абонентом, в качестве имени узла для разрешения DNS.
WINHTTP_OPTION_RESOLVE_TIMEOUT
Задает или извлекает длинное целочисленное значение без знака, содержащее значение времени ожидания в миллисекундах для разрешения имени узла. Значение времени ожидания по умолчанию — INFINITE. Если указано значение, отличное от используемого по умолчанию, для каждого разрешения имен создается один поток.
WINHTTP_OPTION_REVERT_IMPERSONATION_SERVER_CERT
Отменяет любое олицетворение потока при построении цепочки сертификатов сервера, заставляя вместо этого использовать маркер процесса.
WINHTTP_OPTION_SECURE_PROTOCOLS
Задает длинное целое число без знака, указывающее, какие безопасные протоколы являются допустимыми.
- Windows 11, Windows 10 и Windows 8.1. По умолчанию включены только ПРОТОКОЛы SSL3, TLS1.0, TLS1.1 и TLS1.2.
- Windows 8 и Windows 7. По умолчанию включены только ПРОТОКОЛы SSL3 и TLS1.
Значение может быть сочетанием одного или нескольких из следующих значений.
| Термин | Описание |
|---|---|
| WINHTTP_FLAG_SECURE_PROTOCOL_ALL | Можно использовать протоколы SSL 2.0, SSL 3.0 и TLS 1.0. |
| WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 | Можно использовать протокол SSL 2.0. |
| WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 | Можно использовать протокол SSL 3.0. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 | Можно использовать протокол TLS 1.0. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_1 | Можно использовать протокол TLS 1.1. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_2 | Можно использовать протокол TLS 1.2. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_3 | Можно использовать протокол TLS 1.3. |
Если необходимо добавить поддержку протоколов TLS 1.1 или TLS 1.2, но вы не можете перекомпилировать приложение для использования соответствующих значений WINHTTP_OPTION_SECURE_PROTOCOLS, можно добавить DefaultSecureProtocols запись реестра. Эта запись реестра позволяет указать, какие протоколы SSL следует использовать при использовании флага WINHTTP_OPTION_SECURE_PROTOCOLS .
Важно!
Приведенные ниже инструкции включают изменение реестра. При неправильном изменении реестра могут возникнуть серьезные проблемы. Поэтому внимательно следуйте этим инструкциям. Для дополнительной защиты заархивируйте реестр перед внесением изменений. Это позволит восстановить реестр, если возникнут проблемы. Дополнительные сведения о резервном копировании и восстановлении реестра см. в статье Резервное копирование и восстановление реестра в Windows.
Когда приложение указывает WINHTTP_OPTION_SECURE_PROTOCOLS, система проверяет DefaultSecureProtocols запись реестра и, если она присутствует, переопределяет протоколы по умолчанию, указанные в WINHTTP_OPTION_SECURE_PROTOCOLS , протоколами, указанными в DefaultSecureProtocols записи реестра. Если запись реестра отсутствует, WinHTTP использует существующие значения операционной системы по умолчанию для WINHTTP_OPTION_SECURE_PROTOCOLS. Эти значения по умолчанию WinHTTP соответствуют существующим правилам приоритета и отменяются протоколами, отключенными Secure Channel (Schannel), и протоколами, установленными для каждого приложения с помощью WinHttpSetOption.
Вы можете добавить DefaultSecureProtocols запись реестра по следующему пути:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp
На 64-разрядных компьютерах необходимо также добавить DefaultSecureProtocols в Wow6432Node путь:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp
Значение реестра представляет собой растровое изображение DWORD. Используемое значение определяется путем добавления значений, соответствующих требуемым протоколам.
| Значение DefaultSecureProtocols | Протокол включен |
|---|---|
| 0x00000008 | Включение SSL 2.0 по умолчанию |
| 0x00000020 | Включение SSL 3.0 по умолчанию |
| 0x00000080 | Включение TLS 1.0 по умолчанию |
| 0x00000200 | Включение TLS 1.1 по умолчанию |
| 0x00000800 | Включение TLS 1.2 по умолчанию |
Например, если вы хотите переопределить значения по умолчанию для WINHTTP_OPTION_SECURE_PROTOCOLS укажите TLS 1.1 и TLS 1.2. В этом случае возьмем значения tls 1.1 (0x00000200) и TLS 1.2 (0x00000800), сбавьте их в калькулятор (в режиме программиста), и полученное значение реестра будет 0x00000A00.
WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT
Извлекает сертификат для сервера SSL/TLS в структуру WINHTTP_CERTIFICATE_INFO . Приложение должно освободить члены lpszSubjectInfo и lpszIssuerInfo с помощью LocalFree.
WINHTTP_OPTION_SECURITY_FLAGS
Задает или извлекает длинное целое число без знака, содержащее флаги безопасности для дескриптора. Это может быть сочетание следующих значений:
| Термин | Описание |
|---|---|
| SECURITY_FLAG_IGNORE_CERT_CN_INVALID | Разрешает недопустимое общее имя в сертификате; то есть имя сервера, указанное приложением, не соответствует общему имени в сертификате. Если этот флаг установлен, приложение не получает обратный вызов WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID . |
| SECURITY_FLAG_IGNORE_CERT_DATE_INVALID | Разрешает недопустимую дату сертификата, т. е. сертификат с истекшим сроком действия или еще недействителен. Если этот флаг установлен, приложение не получает обратный вызов WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID . |
| SECURITY_FLAG_IGNORE_UNKNOWN_CA | Разрешает недопустимый центр сертификации. Если этот флаг установлен, приложение не получает обратный вызов WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA . |
| SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE | Позволяет установить удостоверение сервера с помощью сертификата, отличного от сервера (например, сертификата клиента). |
| SECURITY_FLAG_IGNORE_WEAK_SIGNATURE | Позволяет игнорировать слабую сигнатуру. Этот флаг доступен в накопительном обновлении для каждой ОС, начиная с Windows 7 и Windows Server 2008 R2. |
| SECURITY_FLAG_SECURE | Использует безопасную передачу данных. Это возвращается только в вызове WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_MEDIUM | Использует среднее (56-разрядное) шифрование. Это возвращается только в вызове WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_STRONG | Использует строгое (128-разрядное) шифрование. Это возвращается только в вызове WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_WEAK | Использует слабое (40-разрядное) шифрование. Это возвращается только в вызове WinHttpQueryOption. |
WINHTTP_OPTION_SECURITY_INFO
Возвращает сведения о подключении SChannel и шифре для запроса.
WINHTTP_OPTION_SECURITY_KEY_BITNESS
Извлекает целочисленное целочисленное значение без знака, содержащее надежность шифра ключа шифрования. Большее число указывает на более надежное шифрование шифра.
WINHTTP_OPTION_SEND_TIMEOUT
Задает или извлекает длинное целочисленное значение без знака, содержащее значение времени ожидания в миллисекундах для отправки запроса или записи некоторых данных. Если отправка запроса занимает больше времени ожидания, операция отправки отменяется. По умолчанию время ожидания составляет 30 секунд.
WINHTTP_OPTION_SERVER_CBT
Возвращает указатель на SecPkgContext_Bindings структуру, указывающую токен привязки канала (CBT).
Маркер привязки канала — это свойство защищенного транспортного канала, которое используется для привязки канала проверки подлинности к защищенному транспортному каналу. Этот маркер можно получить с помощью этого параметра только после установки SSL-подключения.
Примечание
Передача этого параметра и значения NULL для lpBuffer в WinHttpQueryOption вернет ERROR_INSUFFICIENT_BUFFER и требуемый размер байтов для буфера в параметре lpdwBufferLength . Это возвращаемое значение размера буфера можно передать в последующем вызове для запроса маркера привязки канала. Эти действия необходимы при обработке WINHTTP_CALLBACK_STATUS_REQUEST, если вы хотите изменить заголовки запросов на основе маркера привязки канала. Обратите внимание, что Windows XP и Vista не поддерживают изменение заголовков запросов во время этого обратного вызова.
WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT
Извлекает контекст цепочки сертификации сервера. WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT можно передать, чтобы получить дублированный указатель на CERT_CHAIN_CONTEXT для цепочки сертификатов сервера, полученной во время согласованного SSL-соединения. Клиент должен вызвать CertFreeCertificateContext для возвращенного указателя PCCERT_CONTEXT, который заполняется буфером.
WINHTTP_OPTION_SERVER_CERT_CONTEXT
Извлекает контекст сертификации сервера. WINHTTP_OPTION_SERVER_CERT_CONTEXT можно передать, чтобы получить дублированный указатель на CERT CONTEXT для сертификата сервера, полученного во время согласованного SSL-соединения. Клиент должен вызвать CertFreeCertificateContext для возвращенного указателя PCCERT_CONTEXT, который заполняется буфером.
WINHTTP_OPTION_SERVER_SPN_USED
Возвращает имя субъекта-сервера сервера, предоставленное WinHTTP для SSPI во время проверки подлинности. Это строковое значение можно передать в SspiPromptForCredentials после сбоя проверки подлинности.
WINHTTP_OPTION_SPN
Включает или удаляет номер порта сервера при создании имени субъекта-службы (имя субъекта-службы) для проверки подлинности Kerberos или согласования kerberos. Этот флаг является одним из следующих значений:
| Термин | Описание |
|---|---|
| WINHTTP_DISABLE_SPN_SERVER_PORT | Удаляет номер порта сервера. |
| WINHTTP_ENABLE_SPN_SERVER_PORT | Включает номер порта сервера. |
WINHTTP_OPTION_STREAM_ERROR_CODE
Этот параметр можно запросить с помощью дескриптора запроса WinHttp и возвратить код ошибки, указанный кадром RST_STREAM, полученным в потоке HTTP.
WINHTTP_OPTION_TCP_FAST_OPEN
Включает tcp Fast Open для подключения.
WINHTTP_OPTION_TCP_KEEPALIVE
Этот параметр можно задать для дескриптора сеанса WinHttp, чтобы включить режим активности TCP в базовом сокете. Принимает структуру tcp_keepalive .
WINHTTP_OPTION_TLS_FALSE_START
Включает tls False Start для подключения.
WINHTTP_OPTION_TCP_PRIORITY_STATUS
Запросите заданный приоритет сокета TCP с помощью WINHTTP_OPTION_TCP_PRIORITY_HINT. Дополнительные сведения см. в документации по SIO_SET_PRIORITY_HINT .
WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK
Этот параметр можно задать для дескриптора сеанса WinHttp, чтобы указать, разрешен ли откат к TLS 1.0 при сбое подтверждения TLS с более новой версией протокола.
WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT
Принимает событие, которое будет задано после завершения последнего обратного вызова для определенного сеанса. Этот флаг должен использоваться в дескрипторове сеанса. Событие не может быть закрыто до тех пор, пока оно не будет задано WinHTTP.
WINHTTP_OPTION_UNSAFE_HEADER_PARSING
Этот параметр зарезервирован для внутреннего использования и не должен вызываться.
WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET
Указывает стеку запустить процесс подтверждения WebSocket с помощью WinHttpSendRequest. Этот параметр не принимает никаких параметров.
WINHTTP_OPTION_URL
Извлекает строковое значение, содержащее полный URL-адрес скачаемого ресурса. Если исходный URL-адрес содержал какие-либо дополнительные данные, такие как строки поиска или привязки, или если вызов был перенаправлен, возвращаемый URL-адрес отличается от исходного. Приложение должно передавать буфер размером в байтах, который достаточно велик для хранения возвращаемого URL-адреса в формате wide char.
WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS
Принимает BOOL и может быть задан только дескриптор сеанса. Он будет распространяться только на дескрипторы, созданные из дескриптора сеанса после установки параметра. Если задано значение TRUE, этот параметр в качестве последнего средства вызывает использование учетных данных глобального сервера, которые были отправлены из WinInet. Значение по умолчанию для этого параметра — FALSE. Для этого параметра требуется раздел реестра HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Этот раздел реестра отсутствует по умолчанию. Если он задан, WinINet отправит учетные данные в WinHTTP. Всякий раз, когда WinHttp получает запрос на проверку подлинности и если для текущего дескриптора не заданы учетные данные, он будет использовать учетные данные, предоставленные WinINet.
WINHTTP_OPTION_USE_SESSION_SCH_CRED
Позволяет задать одно удостоверение для использования по умолчанию для всех конечных точек в сеансе вместо учетных данных по умолчанию для каждой конечной точки. Это может повысить производительность за счет сокращения затрат на управление учетными данными. Обратите внимание, что эти учетные данные по умолчанию не будут действовать при явном указании сертификата клиента.
WINHTTP_OPTION_USER_AGENT
Задает или извлекает строку агента пользователя для дескрипторов, предоставляемых WinHttpOpen и используемых в последующих функциях WinHttpSendRequest , если она не переопределяется заголовком, добавленным WinHttpAddRequestHeaders или WinHttpSendRequest. При получении агента пользователя приложение должно передать буфер размером в байтах, достаточно большой для хранения возвращаемого URL-адреса в формате wide char. При задании агента пользователя размер буфера равен длине строки в символах, а также признаку конца NULL .
WINHTTP_OPTION_USERNAME
Задает или извлекает строку, содержащую имя пользователя.
WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT
Задает время (в миллисекундах), в течение котором WinHttpWebSocketClose должен ожидать завершения подтверждения закрытия. Значение по умолчанию — 10 секунд.
WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL
Задает интервал (в миллисекундах) для отправки сохраняемого пакета через подключение. Интервал по умолчанию — 30 000 (30 секунд). Минимальный интервал — 15 000 (15 секунд). При использовании WinHttpSetOption для установки значения ниже 15000 возвращается ERROR_INVALID_PARAMETER.
Примечание
Значение по умолчанию для WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL считывается из HKLM:\SOFTWARE\Microsoft\WebSocket\KeepaliveInterval. Если значение не задано, будет использоваться значение по умолчанию 30 000. Невозможно иметь более низкий интервал удержания, чем 15 000 миллисекундах.
WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE
Задает или извлекает значение DWORD, указывающее размер буфера приема для использования в подключениях WebSocket.
WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE
Задает или получает значение DWORD, указывающее размер буфера отправки для использования в подключениях WebSocket.
WINHTTP_OPTION_WORKER_THREAD_COUNT
Задает длинное целое число без знака, указывающее количество рабочих потоков, которые пул потоков должен использовать для асинхронных завершений. Значение этого параметра по умолчанию равно нулю, которое указывает, что количество рабочих потоков равно количеству ЦП в системе. Этот параметр можно задать только для дескриптора NULLHINTERNET до выполнения асинхронной операции. Этот параметр можно задать только один раз.
Область применения: Windows 7 и более поздних версий; Windows Server 2008 R2 и более поздних версий.
WINHTTP_OPTION_WRITE_BUFFER_SIZE
Этот параметр является нерекомендуемой; она не оказывает никакого влияния.
Комментарии
В следующей таблице перечислены флаги параметров, указывая, с какими дескрипторами они могут работать, можно ли запрашивать и задавать, а также используемый тип данных. Значение "X" указывает, что флаг параметра действителен для использования с функцией или дескриптором, а "-" указывает, что флаг параметра является недопустимым.
Попытка задать или запросить флаг параметра в версии Windows, в которой он не поддерживается, приведет к ERROR_WINHTTP_INVALID_OPTION.
| Флаг параметра и тип данных | Дескриптор сеанса | Дескриптор запроса | Параметр запросов | Параметр SET | Минимальная версия Windows |
|---|---|---|---|---|---|
| WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS BOOL |
X | - | - | X | - |
| WINHTTP_OPTION_AUTOLOGON_POLICY DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_BACKGROUND_CONNECTIONS DWORD |
X | - | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_CALLBACK LPVOID |
X | X | X | X | - |
| WINHTTP_OPTION_CLIENT_CERT_CONTEXT CERT_CONTEXT |
- | X | - | X | Windows Vista |
| WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST SecPkgContext_IssuerListInfoEx |
- | X | X | - | Windows Vista |
| WINHTTP_OPTION_CODEPAGE DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_CONNECT_RETRIES DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_CONNECT_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_CONNECTION_INFO WINHTTP_CONNECTION_INFO |
- | X | X | - | - |
| WINHTTP_OPTION_CONNECTION_STATS_V0 TCP_INFO_v0 |
- | X | X | - | Windows 10 версии 1903 |
| WINHTTP_OPTION_CONNECTION_STATS_V1 TCP_INFO_v1 |
- | X | X | - | Windows 10 версии 2004 |
| WINHTTP_OPTION_CONTEXT_VALUE DWORD_PTR |
X | X | X | X | - |
| WINHTTP_OPTION_DECOMPRESSION DWORD |
X | X | - | X | Windows 8.1 |
| WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING BOOL |
X | - | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_DISABLE_FEATURE DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK BOOL |
X | - | - | X | Windows 10 версии 1903 |
| WINHTTP_OPTION_DISABLE_STREAM_QUEUE BOOL |
X | X | - | X | Windows 10 версия 1809 |
| WINHTTP_OPTION_ENABLE_FEATURE DWORD |
* | * | - | X | - |
| WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL DWORD |
X | X | - | X | Windows 10 версии 1607 |
| WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT_CONTEXT BOOL |
X | - | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_ENABLETRACING DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_ENCODE_EXTRA BOOL |
X | X | - | X | Windows 10 версии 1803 |
| WINHTTP_OPTION_EXPIRE_CONNECTION Н/Д |
- | X | - | X | Windows 10 версии 1903 |
| WINHTTP_OPTION_EXTENDED_ERROR DWORD |
X | X | X | - | - |
| WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION BOOL |
X | - | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_GLOBAL_PROXY_CREDS WINHTTP_CREDS |
X | X | - | X | - |
| WINHTTP_OPTION_GLOBAL_SERVER_CREDS WINHTTP_CREDS_EX |
X | X | - | X | - |
| WINHTTP_OPTION_HANDLE_TYPE DWORD |
X | X | X | - | - |
| WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED BOOL |
X | X | - | X | Windows 10 версии 1903 |
| WINHTTP_OPTION_HTTP_PROTOCOL_USED DWORD |
- | X | X | - | Windows 10 версии 1607 |
| WINHTTP_OPTION_HTTP_VERSION HTTP_VERSION_INFO |
X | X | X | X | - |
| WINHTTP_OPTION_HTTP2_KEEPALIVE DWORD |
X | - | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING BOOL |
X | X | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE BOOL |
- | X | - | X | Windows 10 версии 2004 |
| WINHTTP_OPTION_IPV6_FAST_FALLBACK BOOL |
X | - | - | X | Windows 10 версии 1903 |
| WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE BOOL |
X | X | X | - | - |
| WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER DWORD |
X | - | X | X | - |
| WINHTTP_OPTION_MAX_CONNS_PER_SERVER DWORD |
X | - | X | X | - |
| WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_PARENT_HANDLE HINTERNET |
X | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_COBRANDING_URL LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_RETURN_URL LPVOID |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_SIGN_OUT LPVOID |
X | - | - | X | - |
| WINHTTP_OPTION_PASSWORD LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_PROXY WINHTTP_PROXY_INFO |
X | X | X | X | - |
| WINHTTP_OPTION_PROXY_PASSWORD LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_PROXY_SPN_USED LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PROXY_USERNAME LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_READ_BUFFER_SIZE DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE BOOL |
X | X | - | X | - |
| WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_RECEIVE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_REDIRECT_POLICY DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_REJECT_USERPWD_IN_URL BOOL |
- | X | - | X | - |
| WINHTTP_OPTION_REQUEST_PRIORITY DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_REQUEST_STATS WINHTTP_REQUEST_STATS |
- | X | X | - | Windows 10 версии 1903 |
| WINHTTP_OPTION_REQUEST_TIMES WINHTTP_REQUEST_TIMES |
- | X | X | - | Windows 10 версии 1903 |
| WINHTTP_OPTION_REQUIRE_STREAM_END BOOL |
X | X | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_RESOLUTION_HOSTNAME LPWSTR |
- | X | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_RESOLVE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_SECURE_PROTOCOLS DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT WINHTTP_CERTIFICATE_INFO |
- | X | X | - | - |
| WINHTTP_OPTION_SECURITY_FLAGS DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_SECURITY_INFO WINHTTP_SECURITY_INFO |
- | X | X | - | Windows 10 версии 2004 |
| WINHTTP_OPTION_SECURITY_KEY_BITNESS DWORD |
- | X | X | - | - |
| WINHTTP_OPTION_SEND_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_SERVER_CBT SecPkgContext_Bindings* |
- | X | X | - | - |
| WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT CERT_CHAIN_CONTEXT |
- | X | X | - | Windows 10 версии 2004 |
| WINHTTP_OPTION_SERVER_CERT_CONTEXT КОНТЕКСТ CERT |
- | X | X | - | - |
| WINHTTP_OPTION_SERVER_SPN_USED LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_SPN DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_STREAM_ERROR_CODE DWORD |
- | X | X | - | Windows 10, версия 21H1 |
| WINHTTP_OPTION_TCP_FAST_OPEN BOOL |
X | - | - | X | Windows 10 версии 2004 |
| WINHTTP_OPTION_TCP_KEEPALIVE tcp_keepalive |
X | - | - | X | Windows 10 версии 2004 |
| WINHTTP_OPTION_TLS_FALSE_START BOOL |
X | - | - | X | Windows 10 версии 2004 |
| WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK BOOL |
X | - | - | X | Windows 10, версия 21H1 |
| WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT HINTERNET |
X | - | - | X | - |
| WINHTTP_OPTION_UNSAFE_HEADER_PARSING DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET Н/Д |
- | X | - | X | - |
| WINHTTP_OPTION_URL LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS BOOL |
X | X | - | X | - |
| WINHTTP_OPTION_USER_AGENT LPWSTR |
X | - | X | X | - |
| WINHTTP_OPTION_USERNAME LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE DWORD |
X | X | X | X | Windows 8.1 |
| WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE DWORD |
X | X | X | X | Windows 8.1 |
| WINHTTP_OPTION_WORKER_THREAD_COUNT DWORD |
- | - | - | X | - |
| WINHTTP_OPTION_WRITE_BUFFER_SIZE DWORD |
- | X | X | X | - |
Примечание
Для Windows XP и Windows 2000 см. статью Требования к времени выполнения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения] |
| Распространяемые компоненты | WinHTTP 5.0 и Internet Обозреватель 5.01 или более поздней версии в Windows XP и Windows 2000. |
| Заголовок | Winhttp.h |
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по