структура INTERNET_PER_CONN_OPTIONW (wininet.h)

  • Статья

Содержит значение параметра.

Синтаксис

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 Обозреватель 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 и более поздних версий:

Клиенты, поддерживающие Интернет Обозреватель 8, должны запрашивать тип подключения с помощью INTERNET_PER_CONN_FLAGS_UI. Если этот запрос завершается сбоем, в системе выполняется предыдущая версия интернет-Обозреватель и клиент должен снова выполнить запрос с INTERNET_PER_CONN_FLAGS.

Восстановите тип подключения с помощью INTERNET_PER_CONN_FLAGS независимо от версии интернет-Обозреватель.

Значение Значение
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 Обозреватель 5 только версии ANSI InternetQueryOption и InternetSetOption будут работать со структурой INTERNET_PER_CONN_OPTION. Версии Юникода будут поддерживать структуру INTERNET_PER_CONN_OPTION в более поздних версиях Internet Обозреватель.

Для запросов, возвращающих строки, InternetQueryOption выделяет память для элемента pszValue структуры. Вызывающее приложение должно освободить эту память с помощью функции GlobalFree после завершения работы со строкой.

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

Примечание

Заголовок wininet.h определяет INTERNET_PER_CONN_OPTION в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption