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

Функция WinHttpDetectAutoProxyConfigUrl (winhttp.h)

  • Статья

Функция WinHttpDetectAutoProxyConfigUrl находит URL-адрес файла автоконфигурирования прокси-сервера (PAC). Эта функция сообщает URL-адрес PAC-файла, но не загружает файл.

Синтаксис

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

Параметры

[in] dwAutoDetectFlags

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

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

[out] ppwstrAutoConfigUrl

Тип данных, возвращающий указатель на строку Юникода, завершающуюся нулевым значением, которая содержит URL-адрес конфигурации, получающий данные прокси-сервера. Необходимо освободить строку, на которую указывает ppwszAutoConfigUrl , с помощью функции GlobalFree .

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError. Среди возвращаемых кодов ошибок:

Код ошибки Описание
ERROR_WINHTTP_AUTODETECTION_FAILED
 Возвращается, если WinHTTP не удалось обнаружить URL-адрес файла автоматической настройки прокси-сервера (PAC).
ERROR_WINHTTP_INTERNAL_ERROR
 Произошла внутренняя ошибка.
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно памяти для выполнения запрошенной операции. (Код ошибки Windows)

Комментарии

WinHTTP реализует протокол автоматического обнаружения веб-прокси (WPAD), который часто называют автопрокси. Дополнительные сведения об известных расположениях см. в разделе Процесс обнаружения документа по протоколу WPAD.

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

Требования

   
Минимальная версия клиента Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Целевая платформа Windows
Header winhttp.h
Библиотека Winhttp.lib
DLL Winhttp.dll

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

Версии WinHTTP