다음을 통해 공유

WinHttpResetAutoProxy 함수(winhttp.h)

  • 아티클

WinHttpResetAutoProxy 함수는 자동 프록시를 다시 설정합니다.

구문

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

매개 변수

[in] hSession

WinHttpOpen 함수에 대한 이전 호출에서 반환된 유효한 HINTERNET WinHTTP 세션 핸들입니다.

[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 함수를 사용하여 In-process 캐싱을 제거하는 애플리케이션은 hInternet 핸들을 닫고 이후 호출을 위해 새 핸들을 열어야 합니다.

반환 값

작업의 성공 또는 실패를 나타내는 코드입니다.

반환 코드 설명
ERROR_SUCCESS
 작업이 완료되었습니다.
ERROR_INVALID_HANDLE
 hSession 매개 변수가 유효한 핸들이 아닙니다.
ERROR_WINHTTP_INCORRECT_HANDLE TYPE
 hSession 매개 변수는 WinHttpOpen 호출의 산물이 아닙니다.

설명

모든 항목을 다시 설정하려면 WINHTTP_RESET_ALL 및WINHTTP_RESET_OUT_OF_PROC 포함하도록 dwFlags 매개 변수를 설정합니다.

참고WinHttpResetAutoProxy 함수를 후속으로 호출하는 경우 자동 프록시의 상태를 다시 설정하려면 호출 사이에 최소 30초 지연이 있어야 합니다. 30초 미만이면 WinHttpResetAutoProxy 함수 호출이 ERROR_SUCCESS 반환할 수 있지만 다시 설정은 발생하지 않습니다.
 

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winhttp.h
라이브러리 Winhttp.lib
DLL Winhttp.dll