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

Статья
08/27/2023

Функция WinHttpGetIEProxyConfigForCurrentUser извлекает конфигурацию прокси-сервера Обозреватель Интернета для текущего пользователя.

Синтаксис

WINHTTPAPI BOOL WinHttpGetIEProxyConfigForCurrentUser(
  [in, out] WINHTTP_CURRENT_USER_IE_PROXY_CONFIG *pProxyConfig
);

Параметры

[in, out] pProxyConfig

Указатель на входные данные на структуру WINHTTP_CURRENT_USER_IE_PROXY_CONFIG . На выходе структура содержит параметры прокси-сервера Обозреватель Интернета для текущего активного сетевого подключения (например, локального, коммутируемого или VPN-подключения).

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

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

Код ошибки	Описание
ERROR_FILE_NOT_FOUND	Параметры прокси-сервера Обозреватель Интернета не найдены.
ERROR_WINHTTP_INTERNAL_ERROR	Произошла внутренняя ошибка.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для выполнения запрошенной операции. (Код ошибки Windows)

В Обозреватель Интернета параметры прокси-сервера находятся на вкладке Подключения в меню Сервис / Свойства браузера. Параметры прокси-сервера настраиваются для каждого подключения; то есть параметры прокси-сервера для подключения по локальной сети отделены от параметров для коммутируемого или VPN-подключения. WinHttpGetIEProxyConfigForCurrentUser возвращает параметры прокси-сервера для текущего активного подключения.

Эта функция полезна в клиентских приложениях, работающих в сетевых средах, в которых протокол автоматического обнаружения веб-прокси (WPAD) не реализован (это означает, что файл автоматической настройки прокси-сервера недоступен). Если PAC-файл недоступен, функция WinHttpGetProxyForUrl завершается ошибкой . Функцию WinHttpGetIEProxyConfigForCurrentUser можно использовать в качестве резервного механизма для обнаружения работоспособной конфигурации прокси-сервера путем получения конфигурации прокси-сервера пользователя в Интернете Обозреватель.

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

Вызывающий объект должен освободить строки lpszProxy, lpszProxyBypass и lpszAutoConfigUrl в структуре WINHTTP_CURRENT_USER_IE_PROXY_CONFIG , если они не имеют значения NULL. Используйте GlobalFree, чтобы освободить строки.

Требования


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

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

Версии WinHTTP