WinHttpGetIEProxyConfigForCurrentUser 함수(winhttp.h)

  • 아티클

WinHttpGetIEProxyConfigForCurrentUser 함수는 현재 사용자의 인터넷 Explorer 프록시 구성을 검색합니다.

구문

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

매개 변수

[in, out] pProxyConfig

입력에서 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG 구조체에 대한 포인터입니다. 출력 시 구조에는 현재 활성 네트워크 연결(예: LAN, 전화 접속 또는 VPN 연결)에 대한 인터넷 Explorer 프록시 설정이 포함됩니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장된 오류 정보는 GetLastError를 호출합니다. 반환된 오류 코드 중에는 다음과 같습니다.

오류 코드 Description
ERROR_FILE_NOT_FOUND
 인터넷 Explorer 프록시 설정을 찾을 수 없습니다.
ERROR_WINHTTP_INTERNAL_ERROR
 내부 오류가 발생했습니다.
ERROR_NOT_ENOUGH_MEMORY
 메모리가 부족하여 요청된 작업을 완료할 수 없습니다. (Windows 오류 코드)

설명

인터넷 Explorer 프록시 설정은 도구 / 인터넷 옵션 메뉴 옵션의 연결 탭에 있습니다. 프록시 설정은 연결별로 구성됩니다. 즉, LAN 연결에 대한 프록시 설정은 전화 접속 또는 VPN 연결에 대한 프록시 설정과는 별개입니다. WinHttpGetIEProxyConfigForCurrentUser 는 현재 활성 연결에 대한 프록시 설정을 반환합니다.

이 함수는 WPAD(웹 프록시 자동 검색) 프로토콜이 구현되지 않은 네트워크 환경에서 실행되는 클라이언트 애플리케이션에 유용합니다(즉, 프록시 자동 구성 파일을 사용할 수 없음). PAC 파일을 사용할 수 없는 경우 WinHttpGetProxyForUrl 함수가 실패합니다. WinHttpGetIEProxyConfigForCurrentUser 함수를 대체 메커니즘으로 사용하여 인터넷 Explorer 사용자의 프록시 구성을 검색하여 실행 가능한 프록시 구성을 검색할 수 있습니다.

이 함수는 로그온한 사용자를 가장하지 않는 서비스 프로세스에서 사용하면 안 됩니다. 호출자가 로그온한 사용자를 가장하지 않으면 WinHTTP는 현재 서비스 프로세스(예: 로컬 서비스 또는 네트워크 서비스)에 대한 인터넷 Explorer 설정을 검색하려고 시도합니다. 이러한 시스템 계정에 대해 인터넷 Explorer 설정이 구성되지 않은 경우 WinHttpGetIEProxyConfigForCurrentUser에 대한 호출이 실패합니다.

호출자는 NULL이 아닌 경우 WINHTTP_CURRENT_USER_IE_PROXY_CONFIG 구조에서 lpszProxy, lpszProxyBypass 및 lpszAutoConfigUrl 문자열을 해제해야 합니다. GlobalFree를 사용하여 문자열을 해제합니다.

요구 사항

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

추가 정보

WinHTTP 버전