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

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

  • Статья

Функция WinHttpResetAutoProxy сбрасывает автоматический прокси-сервер.

Синтаксис

WINHTTPAPI DWORD WinHttpResetAutoProxy(
  [in] HINTERNET hSession,
  [in] DWORD     dwFlags
);

Параметры

[in] hSession

Допустимый дескриптор сеанса HINTERNET WinHTTP, возвращенный предыдущим вызовом функции WinHttpOpen .

[in] dwFlags

Набор флагов, влияющих на операцию сброса.

Следующие флаги поддерживаются в соответствии с определением в файле заголовка Winhttp.h .

Значение Значение
WINHTTP_RESET_STATE
0x00000001
 Принудительно выполняет очистку и повторную попытку получения сведений о постоянном прокси-сервере в текущей сети.
WINHTTP_RESET_SWPAD_CURRENT_NETWORK
0x00000002
 Сброс сведений pad для текущей сети.
WINHTTP_RESET_SWPAD_ALL
0x00000004
 Очистите сведения pad для всех сетей.
WINHTTP_RESET_SCRIPT_CACHE
0x00000008
 Очистка постоянного кэша HTTP скриптов прокси-сервера.
WINHTTP_RESET_ALL
0x0000FFFF
 Принудительно выполняет очистку и повторную попытку всех сведений о прокси-сервере в текущей сети.
WINHTTP_RESET_NOTIFY_NETWORK_CHANGED
0x00010000
 Сброс сведений о текущем прокси-сервере и уведомление об изменении сети.
WINHTTP_RESET_OUT_OF_PROC
0x00020000
 Работайте со службой autoproxy, а не с текущим процессом.
Примечание Этот флаг является обязательным.
 

Приложения, использующие функцию WinHttpGetProxyForUrl для очистки внутрипроцессного кэширования, должны закрыть дескриптор hInternet и открыть новый дескриптор для будущих вызовов.

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

Код, указывающий на успешное или неудачное выполнение операции.

Код возврата Описание
ERROR_SUCCESS
 Операция выполнена успешно.
ERROR_INVALID_HANDLE
 Параметр hSession не является допустимым дескриптором.
ERROR_WINHTTP_INCORRECT_HANDLE TYPE
 Параметр hSession не является результатом вызова WinHttpOpen.

Комментарии

Чтобы сбросить все данные, задайте параметр dwFlags , включив WINHTTP_RESET_ALL и WINHTTP_RESET_OUT_OF_PROC.

Примечание При последующих вызовах функции WinHttpResetAutoProxy между вызовами должна быть задержка не менее 30 секунд для сброса состояния автоматического прокси-сервера. Если менее 30 секунд, вызов функции WinHttpResetAutoProxy может вернуть ERROR_SUCCESS но сброс не произойдет.
 

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header winhttp.h
Библиотека Winhttp.lib
DLL Winhttp.dll