WinHttpDetectAutoProxyConfigUrl 함수(winhttp.h)

  • 아티클

WinHttpDetectAutoProxyConfigUrl 함수는 PAC(프록시 자동 구성) 파일의 URL을 찾습니다. 이 함수는 PAC 파일의 URL을 보고하지만 파일을 다운로드하지는 않습니다.

구문

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

매개 변수

[in] dwAutoDetectFlags

PAC 파일을 찾는 데 사용할 프로토콜을 지정하는 데이터 형식입니다. DHCP 및 DNS 자동 검색 플래그가 모두 설정된 경우 DHCP가 먼저 사용됩니다. DHCP를 사용하여 PAC URL이 검색되지 않으면 DNS가 사용됩니다.

값 의미
WINHTTP_AUTO_DETECT_TYPE_DHCP
 DHCP를 사용하여 프록시 자동 구성 파일을 찾습니다.
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 DNS를 사용하여 로컬 컴퓨터의 도메인에 있는 잘 알려진 위치에서 프록시 자동 구성 파일을 찾으려고 시도합니다.

[out] ppwstrAutoConfigUrl

프록시 데이터를 수신하는 구성 URL을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터를 반환하는 데이터 형식입니다. GlobalFree 함수를 사용하여 ppwszAutoConfigUrl에서 가리키는 문자열을 해제해야 합니다.

반환 값

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

오류 코드 Description
ERROR_WINHTTP_AUTODETECTION_FAILED
 WinHTTP가 PAC(프록시 자동 구성) 파일의 URL을 검색할 수 없는 경우 반환됩니다.
ERROR_WINHTTP_INTERNAL_ERROR
 내부 오류가 발생했습니다.
ERROR_NOT_ENOUGH_MEMORY
 요청된 작업을 완료하는 데 사용할 수 있는 메모리가 부족합니다. (Windows 오류 코드)

설명

WinHTTP는 WPAD(웹 프록시 자동 검색) 프로토콜을 구현하며, 이를 autoproxy라고도 합니다. 잘 알려진 위치에 대한 자세한 내용은 WPAD 프로토콜 문서의 검색 프로세스 섹션을 참조하세요.

WinHttpDetectAutoProxyConfigUrl 함수는 작업을 완료하는 데 시간이 걸리므로 UI 스레드에서 호출해서는 안 됩니다.

요구 사항

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

추가 정보

WinHTTP 버전