Содержит значение параметра.
Синтаксис
typedef struct {
DWORD dwOption;
union {
DWORD dwValue;
LPWSTR pszValue;
FILETIME ftValue;
} Value;
} INTERNET_PER_CONN_OPTIONW, *LPINTERNET_PER_CONN_OPTIONW;
Члены
dwOption
Параметр для запроса или задания. Этот элемент может быть одним из следующих значений.
Ценность |
Значение |
-
INTERNET_PER_CONN_AUTOCONFIG_URL
|
Задает или извлекает строку, содержащую URL-адрес скрипта автоматической настройки.
|
-
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS
|
Задает или извлекает параметры автоматического обнаружения. Элемент value будет содержать одно или несколько следующих значений:
- AUTO_PROXY_FLAG_ALWAYS_DETECT
-
Всегда автоматически обнаруживать параметры.
- AUTO_PROXY_FLAG_CACHE_INIT_RUN
-
Указывает, что кэшированные результаты скрипта конфигурации автоматического прокси-сервера следует использовать вместо фактического запуска скрипта, если срок действия кэшированного файла не истек.
- AUTO_PROXY_FLAG_DETECTION_RUN
-
Автоматическое обнаружение выполняется по крайней мере один раз в этом подключении.
- AUTO_PROXY_FLAG_DETECTION_SUSPECT
-
В настоящее время не поддерживается.
- AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT
-
Не разрешайте кэширование результата скрипта автоматической конфигурации прокси-сервера.
- AUTO_PROXY_FLAG_MIGRATED
-
Параметр был перенесен из установки Microsoft Internet Explorer 4.0, а автоматическое обнаружение должно выполняться один раз.
- AUTO_PROXY_FLAG_USER_SET
-
Пользователь явно задал автоматическое обнаружение.
|
-
INTERNET_PER_CONN_FLAGS
|
Задает или извлекает тип подключения. Элемент value будет содержать одно или несколько следующих значений:
- PROXY_TYPE_DIRECT
-
Подключение не использует прокси-сервер.
- PROXY_TYPE_PROXY
-
Подключение использует явно заданный прокси-сервер.
- PROXY_TYPE_AUTO_PROXY_URL
-
Подключение загружает и обрабатывает скрипт автоматической настройки по указанному URL-адресу.
- PROXY_TYPE_AUTO_DETECT
-
Подключение автоматически обнаруживает параметры.
|
-
INTERNET_PER_CONN_PROXY_BYPASS
|
Задает или извлекает строку, содержащую URL-адреса, которые не используют прокси-сервер.
|
-
INTERNET_PER_CONN_PROXY_SERVER
|
Задает или извлекает строку, содержащую прокси-серверы.
|
-
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL
|
URL-адрес автоконфигурирования в цепочке. Используется, когда URL-адрес первичной автоконфигурирования указывает на файл INS, который задает второй URL-адрес автоконфигурирования для сведений о прокси-сервере.
|
-
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS
|
в минутах до автоматического обновления URL-адреса автонастройки с помощью автообнаружения.
|
-
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME
|
Параметр только для чтения. Возвращает время последнего известного URL-адреса автоконфигурирования с помощью автообнаружения.
|
-
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL
|
Параметр только для чтения. Возвращает последний известный хороший URL-адрес, найденный с помощью автообнаружения.
|
Windows 7 и более поздних версий:
Клиенты, поддерживающие Internet Explorer 8, должны запрашивать тип подключения с помощью INTERNET_PER_CONN_FLAGS_UI. Если этот запрос завершается ошибкой, система выполняет предыдущую версию Internet Explorer, и клиент должен снова запросить INTERNET_PER_CONN_FLAGS.
Восстановите тип подключения с помощью INTERNET_PER_CONN_FLAGS независимо от версии Internet Explorer.
Ценность |
Значение |
-
INTERNET_PER_CONN_FLAGS_UI
|
Задает или извлекает тип подключения. Элемент value будет содержать одно или несколько следующих значений:
- PROXY_TYPE_DIRECT
-
Подключение не использует прокси-сервер.
- PROXY_TYPE_PROXY
-
Подключение использует явно заданный прокси-сервер.
- PROXY_TYPE_AUTO_PROXY_URL
-
Подключение загружает и обрабатывает скрипт автоматической настройки по указанному URL-адресу.
- PROXY_TYPE_AUTO_DETECT
-
Подключение автоматически обнаруживает параметры.
|
Value
Объединение, содержащее значение параметра. Это может быть любой из следующих типов в зависимости от значения dwOption:
dwValue
Целое число без знака.
pszValue
Указатель на строковое значение.
ftValue
Структура FILETIME.
Value.dwValue
Целое число без знака.
Value.pszValue
Указатель на строковое значение.
Value.ftValue
Структура FILETIME.
В Internet Explorer 5 только версии ANSI InternetQueryOption и InternetSetOption будут работать со структурой INTERNET_PER_CONN_OPTION. Версии Юникода поддерживают структуру INTERNET_PER_CONN_OPTION в более поздних версиях Internet Explorer.
Для запросов, возвращающих строки, InternetQueryOption выделяет память для элемента pszValue. Вызывающее приложение должно освободить эту память с помощью функции GlobalFree после завершения работы со строкой.
Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для реализации или служб сервера
microsoft Windows HTTP Services (WinHTTP).
Заметка
Заголовок wininet.h определяет INTERNET_PER_CONN_OPTION как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
Требование |
Ценность |
минимальные поддерживаемые клиентские |
Windows 2000 Профессиональный [только классические приложения] |
минимальный поддерживаемый сервер |
Windows 2000 Server [только классические приложения] |
заголовка |
wininet.h |
См. также
INTERNET_PER_CONN_OPTION_LIST
InternetQueryOption
InternetSetOption