Функция WinHttpGetIEProxyConfigForCurrentUser (winhttp.h)
Функция 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. Среди возвращаемых кодов ошибок:
| Код ошибки | Описание |
|---|---|
|
Параметры прокси-сервера Обозреватель Интернета не найдены. |
|
Произошла внутренняя ошибка. |
|
Недостаточно памяти для выполнения запрошенной операции. (Код ошибки 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 |