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

Статья
11/20/2024

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

Синтаксис

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

Члены

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 Подключение автоматически обнаруживает параметры.

Ценность

Значение

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

Замечания

В 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

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