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

структура WINHTTP_AUTOPROXY_OPTIONS (winhttp.h)

  • Статья

Структура WINHTTP_AUTOPROXY_OPTIONS используется для указания функции WinHttpGetProxyForURL , следует ли указывать URL-адрес файла автоматической настройки прокси-сервера (PAC) или автоматически находить URL-адрес с помощью DHCP- или DNS-запросов к сети.

Синтаксис

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

Члены

dwFlags

Для получения PAC-файла следует использовать механизмы.

Значение Значение
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 Включает обнаружение прокси-сервера с помощью URL-адреса автонастройки.
 
Примечание Поддержка этого флага появилась в Windows 10 версии 1703 (10.0; Сборка 15063).
 
WINHTTP_AUTOPROXY_ALLOW_CM
 Включает обнаружение прокси-сервера с помощью диспетчера соединений.
 
Примечание Поддержка этого флага появилась в Windows 10 версии 1703 (10.0; Сборка 15063).
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 Включает обнаружение прокси-сервера с помощью статической конфигурации.
 
Примечание Поддержка этого флага появилась в Windows 10 версии 1703 (10.0; Сборка 15063).
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 Попытайтесь автоматически обнаружить URL-адрес PAC-файла с помощью запросов DHCP и DNS к локальной сети.
WINHTTP_AUTOPROXY_CONFIG_URL
 Скачайте PAC-файл по URL-адресу, указанному в lpszAutoConfigUrl в структуре WINHTTP_AUTOPROXY_OPTIONS .
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 Поддерживает регистр имен узлов, передаваемых в скрипт PAC. Это поведение по умолчанию.
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 Преобразует имена узлов в нижний регистр перед их передачей в скрипт PAC.
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 Отключает запрос к узлу к кэшу прокси-сервера результатов выполнения скрипта в текущем процессе.
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 Отключает запросы к узлу к кэшу прокси-сервера результатов выполнения скрипта в службе autoproxy.
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 Отключает запрос параметров прокси-сервера прямого доступа для этого запроса.
WINHTTP_AUTOPROXY_RUN_INPROCESS
 Выполняет протокол автоматического обнаружения веб-прокси (WPAD) внутри процесса вместо делегирования внепроцессной службе WinHTTP AutoProxy, если она доступна. Этот флаг должен быть объединён с одним из других флагов.

Этот параметр не действует при передаче в WinHttpGetProxyForUrlEx.

Примечание Этот флаг является нерекомендуемой.
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 По умолчанию WinHTTP настроен для автоматического обнаружения прокси-сервера в процессе. Если такое резервное поведение нежелательно в случае сбоя обнаружения вне процесса, его можно отключить с помощью этого флага.

Этот параметр не действует при передаче в WinHttpGetProxyForUrlEx.

Примечание Этот флаг доступен только в Windows Server 2003.
 
WINHTTP_AUTOPROXY_SORT_RESULTS
Заказывает результаты прокси-сервера на основе эвристического размещения самых быстрых прокси-серверов первыми.

dwAutoDetectFlags

Если dwFlags содержит флаг WINHTTP_AUTOPROXY_AUTO_DETECT, то dwAutoDetectFlags указывает, какие протоколы следует использовать для поиска PAC-файла. Если указаны флаги автоматического обнаружения DHCP и DNS, то сначала используется DHCP; Если URL-адрес PAC не обнаружен с помощью DHCP, используется DNS.

Если параметр dwFlags не содержит флаг WINHTTP_AUTOPROXY_AUTO_DETECT, параметр dwAutoDetectFlags должен иметь нулевое значение.

Значение Значение
WINHTTP_AUTO_DETECT_TYPE_DHCP
 Используйте DHCP для поиска файла автоматической конфигурации прокси-сервера.
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 Используйте DNS, чтобы попытаться найти файл автоматической конфигурации прокси-сервера в известном расположении в домене локального компьютера.

lpszAutoConfigUrl

Если dwFlags включает флаг WINHTTP_AUTOPROXY_CONFIG_URL, lpszAutoConfigUrl должен указывать на строку Юникода, завершающуюся null, которая содержит URL-адрес файла автоматической настройки прокси-сервера (PAC).

Если параметр dwFlags не содержит флаг WINHTTP_AUTOPROXY_CONFIG_URL, то параметр lpszAutoConfigUrl должен иметь значение NULL.

lpvReserved

Зарезервировано для использования в будущем; значение должно иметь значение NULL.

dwReserved

Зарезервировано для будущего использования; должно иметь значение нуль.

fAutoLogonIfChallenged

Указывает, следует ли автоматически отправлять учетные данные домена клиента в ответ на запрос проверки подлинности NTLM или Negotiate, когда WinHTTP запрашивает PAC-файл.

Если этот флаг имеет значение TRUE, учетные данные должны отправляться автоматически в ответ на запрос проверки подлинности. Если этот флаг имеет значение FALSE и для скачивания PAC-файла требуется проверка подлинности, функция WinHttpGetProxyForUrl завершается ошибкой .

Требования

Требование Значение
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Верхняя часть winhttp.h

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

Версии WinHTTP