Флаги параметров (Wininet.h)

Следующие флаги параметров используются с функциями InternetQueryOption и InternetSetOption . Все допустимые флаги параметров имеют значение больше или равно INTERNET_FIRST_OPTION и меньше или равно INTERNET_LAST_OPTION.

INTERNET_OPTION_ALTER_IDENTITY

80

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

INTERNET_OPTION_ASYNC

30

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

INTERNET_OPTION_ASYNC_ID

15

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

INTERNET_OPTION_ASYNC_PRIORITY

16

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

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

Задает или извлекает логическое значение, определяющее, должна ли система проверка сеть для более нового содержимого, и перезаписывать измененные записи кэша при обнаружении более новой версии. Если задано значение True, система проверяет сеть на наличие нового содержимого и перезаписывает измененную запись кэша более новой версией. Значение по умолчанию — False, указывающее, что измененная запись кэша должна использоваться без проверки сети. Используется InternetQueryOption и InternetSetOption. Он действителен только в Microsoft Internet Обозреватель 5 и более поздних версиях.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

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

INTERNET_OPTION_CACHE_TIMESTAMPS

69

Извлекает структуру INTERNET_CACHE_TIMESTAMPS , содержащую значение LastModified time и Expires time из ресурса, хранящегося в кэше Интернета. Это значение используется InternetQueryOption.

INTERNET_OPTION_CALLBACK

1

Задает или извлекает адрес функции обратного вызова, определенной для этого дескриптора. Этот параметр можно использовать для всех дескрипторов HINTERNET . Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_CALLBACK_FILTER

54

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

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

Этот флаг не поддерживается InternetQueryOption. Параметр lpBuffer должен быть указателем на структуру CERT_CONTEXT , а не указателем на указатель CERT_CONTEXT . Если приложение получает ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED, оно должно вызвать InternetErrorDlg или использовать InternetSetOption для предоставления сертификата, прежде чем повторить запрос. Затем вызывается CertDuplicateCertificateContext, чтобы переданный контекст сертификата можно было независимо освободить приложением.

INTERNET_OPTION_CODEPAGE

68

По умолчанию часть URL-адреса Юникода узла или центра закодирована в соответствии со спецификацией IDN. Установка этого параметра для запроса или дескриптора подключения при отключении IDN определяет схему кодирования кодовых страниц для хост-части URL-адреса. Параметр lpBuffer в вызове InternetSetOption содержит требуемую кодовую страницу DBCS. Если в lpBuffer не указана кодовая страница, WinINet использует системную кодовую страницу по умолчанию (CP_ACP). Примечание. Этот параметр игнорируется, если IDN не отключен. Дополнительные сведения об отключении IDN см. в разделе параметр INTERNET_OPTION_IDN .

Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003 с пакетом обновления 1 (SP1): Этот флаг не поддерживается.

Версия: Требуется Internet Обозреватель 7.0.

INTERNET_OPTION_CODEPAGE_PATH

100

По умолчанию часть пути URL-адреса имеет кодировку UTF8. API WinINet выполняет кодирование escape-символов (%) для высокобитовых символов. Установка этого параметра для запроса или дескриптора подключения отключает кодировку UTF8 и задает определенную кодовую страницу. Параметр lpBuffer в вызове InternetSetOption содержит требуемую кодовую страницу DBCS для пути. Если кодовая страница не указана в lpBuffer, WinINet использует CP_UTF8 по умолчанию.

Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003 с пакетом обновления 1 (SP1): Этот флаг не поддерживается.

Версия: Требуется Internet Обозреватель 7.0.

INTERNET_OPTION_CODEPAGE_EXTRA

101

По умолчанию частью пути URL-адреса является системная кодовая страница по умолчанию (CP_ACP). Преобразования escape-символов (%) не выполняются в дополнительной части. Установка этого параметра для запроса или дескриптора подключения отключает кодировку CP_ACP. Параметр lpBuffer в вызове InternetSetOption содержит требуемую кодовую страницу DBCS для дополнительной части URL-адреса. Если в lpBuffer не указана кодовая страница, WinINet использует системную кодовую страницу по умолчанию (CP_ACP).

Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003 с пакетом обновления 1 (SP1): Этот флаг не поддерживается.

Версия: Требуется Internet Обозреватель 7.0.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

Для запроса, в котором WinInet распаковывает предоставленные сервером Content-Encoding, извлекает сообщаемое сервером значение Content-Length текста ответа в виде ULONGLONG. Поддерживается в Windows 10 версии 1507 и более поздних.

INTERNET_OPTION_CONNECT_BACKOFF

4

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

INTERNET_OPTION_CONNECT_RETRIES

3

Задает или извлекает длинное целочисленное значение без знака, содержащее количество попыток WinINet разрешить и подключиться к узлу. Он пытается выполнить только один раз для КАЖДОГО IP-адреса. Например, если вы пытаетесь подключиться к узлу с несколькими адресами с десятью IP-адресами и INTERNET_OPTION_CONNECT_RETRIES установлено значение семь, WinINet попытается разрешить и подключиться только к первым семи IP-адресам. И наоборот, при том же наборе из десяти IP-адресов, если INTERNET_OPTION_CONNECT_RETRIES имеет значение 20, WinINet пытается выполнить попытку каждого из десяти только один раз. Если узел имеет только один IP-адрес и первая попытка подключения завершается неудачей, дальнейшие попытки отсутствуют. Если попытка подключения по-прежнему завершается сбоем после указанного количества попыток, запрос отменяется. Значение по умолчанию для INTERNET_OPTION_CONNECT_RETRIES равно пяти попыткам. Этот параметр можно использовать для любого дескриптора HINTERNET , включая дескриптор NULL . Он используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_CONNECT_TIME

55

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

INTERNET_OPTION_CONNECT_TIMEOUT

2

Задает или извлекает длинное целочисленное значение без знака, содержащее значение времени ожидания (в миллисекундах), используемое для запросов подключения к Интернету. Если этот параметр задан как бесконечный (0xFFFFFFFF), этот таймер будет отключен.

Если запрос на подключение занимает больше времени ожидания, запрос отменяется. При попытке подключения к нескольким IP-адресам для одного узла (узла с несколькими домами) ограничение времени ожидания является накопительным для всех IP-адресов. Этот параметр можно использовать для любого дескриптора HINTERNET , включая маркер NULL . Он используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_CONNECTED_STATE

50

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

INTERNET_OPTION_CONTEXT_VALUE

45

Задает или извлекает DWORD_PTR, содержащую адрес контекстного значения, связанного с этим дескриптором HINTERNET . Этот параметр можно использовать для любого дескриптора HINTERNET . Используется InternetQueryOption и InternetSetOption. Ранее в качестве значения контекста задается адрес, хранящийся в указателе lpBuffer . Это исправлено, чтобы использовать значение, хранящееся в буфере, и флагу INTERNET_OPTION_CONTEXT_VALUE присваивается новое значение. Старое значение 10 сохранено, поэтому приложения, написанные для старого поведения, по-прежнему поддерживаются.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

Идентично INTERNET_OPTION_RECEIVE_TIMEOUT. Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

Идентично INTERNET_OPTION_SEND_TIMEOUT. Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

Задает или извлекает длинное целое число без знака, содержащее значение времени ожидания (в миллисекундах), чтобы получить ответ на запрос для канала данных FTP-транзакции. Если ответ занимает больше времени ожидания, запрос отменяется. Этот параметр можно использовать для любого дескриптора HINTERNET , включая маркер NULL . Он используется InternetQueryOption и InternetSetOption.

Этот флаг не влияет на функциональные возможности HTTP.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

Задает или извлекает длинное целое число без знака (в миллисекундах), содержащее значение времени ожидания для отправки запроса к каналу данных FTP-транзакции. Если отправка занимает больше времени, чем это значение времени ожидания, отправка отменяется. Этот параметр можно использовать для любого дескриптора HINTERNET , включая маркер NULL . Он используется InternetQueryOption и InternetSetOption.

Этот флаг не влияет на функциональные возможности HTTP.

INTERNET_OPTION_DATAFILE_NAME

33

Извлекает строковое значение, содержащее имя файла, поддерживающего скачаемую сущность. Этот флаг действителен после завершения работы InternetOpenUrl, FtpOpenFile, GopherOpenFile или HttpOpenRequest . Этот параметр может запрашиваться только InternetQueryOption.

INTERNET_OPTION_DATAFILE_EXT

96

Задает строковое значение, содержащее расширение файла, поддерживающего скачаемую сущность. Этот флаг следует установить перед вызовом InternetOpenUrl, FtpOpenFile, GopherOpenFile или HttpOpenRequest. Этот параметр можно задать только с помощью InternetSetOption.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

Извлекает структуру INTERNET_DIAGNOSTIC_SOCKET_INFO , содержащую данные об указанном HTTP-запросе. Этот флаг используется InternetQueryOption.

Windows 7: Этот параметр больше не поддерживается.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

Заставляет систему выйти из пакета SSPI дайджест-проверки подлинности, очищая все учетные данные, созданные для процесса. Для этого параметра буфер не требуется. Он используется InternetSetOption.

INTERNET_OPTION_DISABLE_AUTODIAL

70

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

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

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

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

Задает битовую маску DWORD допустимых расширенных версий HTTP. Может быть задан для любого типа дескриптора. Возможны следующие значения:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Поддерживается в Windows 10 версии 1507 и более поздних.

Устаревшие версии HTTP (1.1 и более ранние версии) нельзя отключить с помощью этого параметра. Значение по умолчанию — 0x0. Поддерживается в Windows 10 версии 1507 и более поздних.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

Для дескриптора запроса задает логическое значение, определяющее, будут ли перенаправления возвращаться из кэша WinInet для данного запроса. Значение по умолчанию — FALSE. Поддерживается в Windows 8 и более поздних версиях.

INTERNET_OPTION_ENCODE_EXTRA

155

Возвращает/задает значение BOOL, указывающее, должны ли символы, отличные от ASCII, в строке запроса кодироваться в процентах. Значение по умолчанию — FALSE. Поддерживается в Windows 8.1 и более поздних версиях.

INTERNET_OPTION_END_BROWSER_SESSION

42

Очищает записи, которые не используются, из кэша паролей на жестком диске. Также сбрасывает время кэша, используемое в режиме синхронизации один раз в сеансе. Для этого параметра буфер не требуется. Используется InternetSetOption.

INTERNET_OPTION_ERROR_MASK

62

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

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

Указывает, что все ошибки сертификата должны сообщаться с помощью одного и того же возвращаемого значения ошибки, а именно ERROR_INTERNET_SEC_CERT_ERRORS. Если этот флаг установлен, вызовите InternetErrorDlg при получении ошибки ERROR_INTERNET_SEC_CERT_ERRORS , чтобы пользователь смог ответить на знакомое диалоговое окно с описанием проблемы.

Внимание!

Если пользователь не сообщит об этой ошибке, он подвергается потенциальным атакам спуфингом.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

Указывает, что клиентское приложение может обрабатывать код ошибки ERROR_INTERNET_INSERT_CDROM .

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

Указывает, что клиентское приложение может обрабатывать код ошибки ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY .

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

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

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

Задает PWSTR, содержащий корпоративный идентификатор (см. https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx), который применяется к запросу. Поддерживается в Windows 10 версии 1507 и более поздних.

INTERNET_OPTION_EXTENDED_ERROR

24

Извлекает длинное целочисленное значение без знака, содержащее код ошибки Winsock, сопоставленный с ERROR_INTERNET_ сообщений об ошибках, которые в последний раз возвращались в контексте этого потока. Этот параметр используется для дескриптора NULLHINTERNETв InternetQueryOption.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

Задает или извлекает длинное целое число без знака без знака, содержащее время, в течение которого система должна ожидать ответа на сетевой запрос, прежде чем проверять кэш для копии ресурса. Если сетевой запрос занимает больше указанного времени и запрошенный ресурс доступен в кэше, ресурс извлекается из кэша. Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_HANDLE_TYPE

9

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

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157

Возвращает/задает значение BOOL, указывающее, должен ли WinInet следовать директивам HTTP Strict Transport Security (HSTS) с серверов. Если этот параметр включен, https:// запланированные запросы к доменам с политикой HSTS, кэшируемыми WinInet, будут перенаправлены на соответствующие URL-адреса https://. Значение по умолчанию — FALSE. Поддерживается в Windows 8.1 и более поздних версиях.

INTERNET_OPTION_HTTP_DECODING

65

Позволяет WinINet выполнять декодирование схем кодирования gzip и deflate. Дополнительные сведения см. в разделе Кодирование содержимого.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

Возвращает значение DWORD, указывающее, какая расширенная версия HTTP использовалась в данном запросе. Возможны следующие значения:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Поддерживается в Windows 10 версии 1507 и более поздних.

0x0 указывает http/1.1 или более ранней версии; См. INTERNET_OPTION_HTTP_VERSION, если требуется более точное определение используемой устаревшей версии. Поддерживается в Windows 10 версии 1507 и более поздних.

INTERNET_OPTION_HTTP_VERSION

59

Задает или извлекает структуру HTTP_VERSION_INFO , содержащую поддерживаемую версию HTTP. Его необходимо использовать для дескриптора NULL . Используется InternetQueryOption и InternetSetOption.

В Windows 7, Windows Server 2008 R2 и более поздних версиях значение элемента dwMinorVersion в структуре HTTP_VERSION_INFO переопределяется параметрами Обозреватель Интернета. EnableHttp1_1 — это значение реестра в разделе HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE, управляемое параметрами браузера, установленными в Обозреватель Интернета для системы. Значение EnableHttp1_1 по умолчанию равно 1. Структура HTTP_VERSION_INFO игнорируется для любой версии HTTP ниже 1.1, если EnableHttp1_1 имеет значение 1.

INTERNET_OPTION_IDENTITY

78

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

INTERNET_OPTION_IDLE_STATE

51

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

INTERNET_OPTION_IDN

102

По умолчанию часть URL-адреса узла или центра закодирована в соответствии со спецификацией IDN для прямых и прокси-подключений. Этот параметр можно использовать в запросе или дескрипторе подключения для включения или отключения IDN. Если IDN отключен, WinINet использует системную кодовую страницу для кодирования части узла или центра URL-адреса. Чтобы отключить преобразование узла IDN, задайте для параметра lpBuffer в вызове InternetSetOption значение 0. Чтобы включить преобразование IDN только для прямого подключения, укажите INTERNET_FLAG_IDN_DIRECT в параметре lpBuffer в вызове InternetSetOption. Чтобы включить преобразование IDN только для прокси-подключения, укажите INTERNET_FLAG_IDN_PROXY в параметре lpBuffer в вызове InternetSetOption.

Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003 с пакетом обновления 1 (SP1): Этот флаг не поддерживается.

Версия: Требуется Internet Обозреватель 7.0.

INTERNET_OPTION_IGNORE_OFFLINE

77

Задает или извлекает значение, указывающее, следует ли игнорировать глобальный автономный флаг для указанного дескриптора запроса. Для этого параметра буфер не требуется. Он используется InternetQueryOption и InternetSetOption с дескриптором запроса. Этот параметр действителен только в Internet Обозреватель 5 и более поздних версий.

INTERNET_OPTION_KEEP_CONNECTION

22

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

INTERNET_OPTION_LISTEN_TIMEOUT

11

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

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

Задает или извлекает длинное целое число без знака, содержащее максимально допустимое количество подключений для каждого сервера HTTP/1.0. Используется InternetQueryOption и InternetSetOption. Этот параметр действителен только в Internet Обозреватель 5 и более поздних версий.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

Задает или извлекает длинное целое число без знака, содержащее максимально допустимое количество подключений на прокси-сервер CERN. При установке или извлечении этого параметра параметр hInternet должен иметь значение NULL дескриптора. Значение дескриптора null указывает, что параметр должен быть задан или запрошен для текущего процесса. При вызове InternetSetOption с этим параметром все существующие прокси-объекты получат новое значение. Это значение ограничено диапазоном от 2 до 128 включительно.

Версия: Требуется Internet Обозреватель 8.0.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

Задает или извлекает целочисленное значение без знака, содержащее максимально допустимое количество подключений для каждого сервера. Используется InternetQueryOption и InternetSetOption. Этот параметр действителен только в Internet Обозреватель 5 и более поздних версий.

INTERNET_OPTION_OFFLINE_MODE

26

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

INTERNET_OPTION_OFFLINE_SEMANTICS

52

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

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

Согласие на использование слабых сигнатур (например, SHA-1), которые будут рассматриваться как небезопасные. В этом случае WinInet будет вызывать CertGetCertificateChain с помощью параметра CERT_CHAIN_OPT_IN_WEAK_SIGNATURE .

INTERNET_OPTION_PARENT_HANDLE

21

Извлекает родительский дескриптор для этого дескриптора. Этот параметр можно использовать для любого дескриптора HINTERNETв InternetQueryOption.

INTERNET_OPTION_PASSWORD

29

Задает или извлекает строковое значение, содержащее пароль, связанный с дескриптором, возвращенным InternetConnect. Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_PER_CONNECTION_OPTION

75

Задает или извлекает структуру INTERNET_PER_CONN_OPTION_LIST , указывающую список параметров для определенного соединения. Используется InternetQueryOption и InternetSetOption. Этот параметр действителен только в Internet Обозреватель 5 и более поздних версий.

Примечание

INTERNET_OPTION_PER_CONNECTION_OPTION приводит к изменению параметров на уровне всей системы при использовании дескриптора NULL в вызове InternetSetOption. Чтобы обновить глобальные параметры прокси-сервера, необходимо вызвать InternetSetOption с флагом параметра INTERNET_OPTION_REFRESH .

Примечание

Чтобы изменить сведения о прокси-сервере для всего процесса, не затрагивая глобальные параметры в Интернете Обозреватель 5 и более поздних версий, используйте этот параметр для дескриптора, возвращаемого из InternetOpen. В следующем примере кода прокси-сервер изменяется для всего процесса, несмотря на то, что дескриптор HINTERNET закрыт и не используется никакими запросами.

INTERNET_OPTION_POLICY

48

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

INTERNET_OPTION_PROXY

38

Задает или извлекает структуру INTERNET_PROXY_INFO , содержащую данные прокси-сервера для существующего дескриптора InternetOpen , если дескриптор HINTERNET не равен NULL. Если дескриптор HINTERNET имеет значение NULL, функция задает или запрашивает данные глобального прокси-сервера. Этот параметр можно использовать для дескриптора, возвращаемого InternetOpen. Он используется InternetQueryOption и InternetSetOption.

Примечание

Вместо INTERNET_OPTION_PROXY рекомендуется использовать INTERNET_OPTION_PER_CONNECTION_OPTION.

INTERNET_OPTION_PROXY_PASSWORD

44

Задает или получает строковое значение, содержащее пароль, используемый для доступа к прокси-серверу. Используется InternetQueryOption и InternetSetOption. Этот параметр можно задать для дескриптора, возвращаемого InternetConnect или HttpOpenRequest.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

Оповещает текущий экземпляр WinInet об изменении параметров прокси-сервера и о том, что они должны обновиться с учетом новых параметров. Чтобы оповещать все доступные экземпляры WinInet, задайте для параметра BufferinternetSetOptionзначение NULL , а для BufferLength — значение 0 при передаче этого параметра. Этот параметр можно задать для дескриптора, возвращаемого InternetConnect или HttpOpenRequest.

INTERNET_OPTION_PROXY_USERNAME

43

Задает или извлекает строковое значение, содержащее имя пользователя, используемое для доступа к прокси-серверу. Используется InternetQueryOption и InternetSetOption. Этот параметр можно задать для дескриптора, возвращаемого InternetConnect или HttpOpenRequest.

INTERNET_OPTION_READ_BUFFER_SIZE

12

Задает или извлекает целочисленное значение без знака, содержащее размер буфера чтения. Этот параметр можно использовать для дескрипторов HINTERNET , возвращаемых ftpOpenFile, FtpFindFirstFile и InternetConnect (только сеанс FTP). Этот параметр используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

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

INTERNET_OPTION_RECEIVE_TIMEOUT

6

Задает или извлекает длинное целочисленное значение без знака, содержащее значение времени ожидания в миллисекундах, чтобы получить ответ на запрос. Если ответ занимает больше времени ожидания, запрос отменяется. Этот параметр можно использовать для любого дескриптора HINTERNET , включая дескриптор NULL . Он используется InternetQueryOption и InternetSetOption.

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

При использовании в связи с ftp-транзакцией этот параметр ссылается на канал управления.

INTERNET_OPTION_REFRESH

37

Вызывает повторное считывать данные прокси-сервера из реестра для дескриптора. Буфер не требуется. Этот параметр можно использовать для дескриптора HINTERNET, возвращаемого InternetOpen. Он используется InternetSetOption.

INTERNET_OPTION_REMOVE_IDENTITY

79

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

INTERNET_OPTION_REQUEST_FLAGS

23

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

INTERNET_REQFLAG_ASYNC

0x00000002

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

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

Интернет-запрос не может быть кэширован (например, HTTPS-запрос).

INTERNET_REQFLAG_FROM_CACHE

0x00000001

Ответ пришел из кэша.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

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

INTERNET_REQFLAG_NO_HEADERS

0x00000008

Исходный ответ не содержал заголовков.

INTERNET_REQFLAG_PASSIVE

0x00000010

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

INTERNET_REQFLAG_VIA_PROXY

0x00000004

Запрос был сделан через прокси-сервер.

INTERNET_OPTION_REQUEST_PRIORITY

58

Задает или извлекает длинное целое число без знака, содержащее приоритет запросов, конкурирующих за подключение по дескриптору HTTP. Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

Запускает новый сеанс кэша для процесса. Буфер не требуется. Используется InternetSetOption. Этот параметр зарезервирован только для внутреннего использования.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

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

INTERNET_OPTION_SECURITY_CERTIFICATE

35

Извлекает сертификат для сервера SSL/PCT (технология secure Sockets Layer/Private Communications Technology) в форматированную строку. Используется InternetQueryOption.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

Извлекает сертификат для сервера SSL/PCT в структуру INTERNET_CERTIFICATE_INFO. Используется InternetQueryOption.

INTERNET_OPTION_SECURITY_FLAGS

31

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

SECURITY_FLAG_128BIT

0x20000000

Идентично предпочтительному значению SECURITY_FLAG_STRENGTH_STRONG. Это возвращается только при вызове InternetQueryOption.

SECURITY_FLAG_40BIT

0x10000000

Идентично предпочтительному значению SECURITY_FLAG_STRENGTH_WEAK. Это возвращается только при вызове InternetQueryOption.

SECURITY_FLAG_56BIT

0x40000000

Идентично предпочтительному значению SECURITY_FLAG_STRENGTH_MEDIUM. Это возвращается только при вызове InternetQueryOption.

SECURITY_FLAG_FORTEZZA

0x08000000

Указывает, что Fortezza использовалась для обеспечения секретности, проверки подлинности и (или) целостности указанного подключения.

SECURITY_FLAG_IETFSSL4

0x00000020

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

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Игнорирует сообщение об ошибке ERROR_INTERNET_SEC_CERT_CN_INVALID .

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Игнорирует сообщение об ошибке ERROR_INTERNET_SEC_CERT_DATE_INVALID .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Игнорирует сообщение об ошибке ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Игнорирует сообщение об ошибке ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR .

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

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

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

Игнорирует неизвестные проблемы центра сертификации.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

Игнорирует проблемы с подписью слабого сертификата.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

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

SECURITY_FLAG_NORMALBITNESS

0x10000000

Идентично значению SECURITY_FLAG_STRENGTH_WEAK. Это значение возвращается только при вызове InternetQueryOption.

SECURITY_FLAG_PCT

0x00000008

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

SECURITY_FLAG_PCT4

0x00000010

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

SECURITY_FLAG_SECURE

0x00000001

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

SECURITY_FLAG_SSL

0x00000002

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

SECURITY_FLAG_SSL3

0x00000004

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

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

Использует среднее (56-разрядное) шифрование. Это значение возвращается только при вызове InternetQueryOption.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

Использует строгое (128-разрядное) шифрование. Это значение возвращается только при вызове InternetQueryOption.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

Использует слабое (40-разрядное) шифрование. Это значение возвращается только при вызове InternetQueryOption.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

Размер бита, используемого в шифровании, неизвестен. Это значение возвращается только при вызове InternetQueryOption.

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

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

Извлекает длинное целочисленное значение без знака, содержащее битовый размер ключа шифрования. Чем больше число, тем выше используемая стойкость шифрования. Используется InternetQueryOption. Имейте в виду, что данные, полученные таким образом, связаны с уже выполненной транзакцией, уровень безопасности которой больше нельзя изменить.

INTERNET_OPTION_SEND_THROUGHPUT

56

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

INTERNET_OPTION_SEND_TIMEOUT

5

Задает или извлекает длинное целое число без знака в миллисекундах, содержащее значение времени ожидания для отправки запроса. Если отправка занимает больше времени ожидания, отправка отменяется. Этот параметр можно использовать для любого дескриптора HINTERNET , включая дескриптор NULL . Он используется InternetQueryOption и InternetSetOption.

При использовании в связи с ftp-транзакцией этот параметр ссылается на канал управления.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

Извлекает контекст цепочки сертификатов сервера в виде дублированного PCCERT_CHAIN_CONTEXT. Этот повторяющийся контекст можно передать в любую функцию API шифрования, которая принимает PCCERT_CHAIN_CONTEXT. После завершения работы с контекстом цепочки сертификатов необходимо вызвать CertFreeCertificateChain для возвращаемого PCCERT_CHAIN_CONTEXT .

Версия: Требуется Internet Обозреватель 8.0.

INTERNET_OPTION_SETTINGS_CHANGED

39

Уведомляет систему о том, что параметры реестра были изменены, чтобы проверить параметры при следующем вызове InternetConnect. Используется InternetSetOption.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

Задает объект HTTP-запроса таким образом, чтобы он не выполнял вход на серверы-источники, но выполнял автоматический вход на прокси-серверы HTTP. Этот параметр отличается от флага запроса INTERNET_FLAG_NO_AUTH, который предотвращает проверку подлинности как на прокси-серверах, так и на серверах-источниках.

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

Чтобы обеспечить подавление всех идентификационных сведений, вызывающий объект должен объединить INTERNET_OPTION_SUPPRESS_SERVER_AUTH с флагом запроса INTERNET_FLAG_NO_COOKIES .

Этот параметр можно задать только для объектов запроса до их отправки. Попытка задать этот параметр после отправки запроса вернет ERROR_INTERNET_INCORRECT_HANDLE_STATE.

Для этого параметра буфер не требуется. Он используется InternetSetOption для дескрипторов, возвращаемых только HttpOpenRequest .

Версия: Требуется Интернет Обозреватель 8.0 или более поздней версии.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

Параметр общего назначения, используемый для подавления поведения на уровне всего процесса. Параметр lpBuffer функции должен быть указателем на DWORD, содержащий конкретное поведение для подавления. Этот параметр не может быть запрошен с помощью InternetQueryOption. Допустимые значения:

INTERNET_SUPPRESS_RESET_ALL

0

Отключает все подавления, повторно включив поведение по умолчанию и настроенное поведение. Этот параметр эквивалентен настройке INTERNET_SUPPRESS_COOKIE_POLICY_RESET и INTERNET_SUPPRESS_COOKIE_PERSIST_RESET по отдельности.

Версия: Требуется Internet Обозреватель 6.0 или более поздней версии.

INTERNET_SUPPRESS_COOKIE_POLICY

1

Игнорирует все настроенные политики файлов cookie и разрешает настройку файлов cookie.

Версия: Требуется Internet Обозреватель 6.0 или более поздней версии.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

Отключает подавление INTERNET_SUPPRESS_COOKIE_POLICY , позволяя оценивать файлы cookie в соответствии с настроенной политикой файлов cookie.

Версия: Требуется Internet Обозреватель 6.0 или более поздней версии.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

Подавляет сохранение файлов cookie, даже если сервер указал их как постоянные.

Версия: Требуется Интернет Обозреватель 8.0 или более поздней версии.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

Отключает подавление INTERNET_SUPPRESS_COOKIE_PERSIST , повторно включив сохранение файлов cookie. Все ранее подавленные файлы cookie не станут постоянными.

Версия: Требуется Интернет Обозреватель 8.0 или более поздней версии.

INTERNET_OPTION_URL

34

Извлекает строковое значение, содержащее полный URL-адрес скачаемого ресурса. Если исходный URL-адрес содержал какие-либо дополнительные данные, такие как строки поиска или привязки, или если вызов был перенаправлен, возвращаемый URL-адрес отличается от исходного. Этот параметр допустим для дескрипторов HINTERNET , возвращаемых InternetOpenUrl, FtpOpenFile, GopherOpenFile или HttpOpenRequest. Он используется InternetQueryOption.

INTERNET_OPTION_USER_AGENT

41

Задает или извлекает строку агента пользователя для дескрипторов, предоставляемых InternetOpen и используемых в последующих функциях HttpSendRequest , если она не переопределяется заголовком, добавленным HttpAddRequestHeaders или HttpSendRequest. Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_USERNAME

28

Задает или извлекает строку, содержащую имя пользователя, связанное с дескриптором, возвращенным InternetConnect. Используется InternetQueryOption и InternetSetOption.

INTERNET_OPTION_VERSION

40

Извлекает структуру INTERNET_VERSION_INFO , содержащую номер версии Wininet.dll. Этот параметр можно использовать для дескриптора NULLHINTERNETв InternetQueryOption.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

Задает или извлекает целое число без знака, содержащее размер буфера записи в байтах. Этот параметр можно использовать для дескрипторов HINTERNET , возвращаемых ftpOpenFile и InternetConnect (только сеанс FTP). Он используется InternetQueryOption и InternetSetOption.

Комментарии

Примечание

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

Требования

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