다음을 통해 공유

WINHTTP_AUTOPROXY_OPTIONS 구조체(winhttp.h)

  • 아티클

WINHTTP_AUTOPROXY_OPTIONS 구조체는 WinHttpGetProxyForURL 함수에 PAC(프록시 자동 구성) 파일의 URL을 지정할지 또는 DHCP 또는 DNS 쿼리를 사용하여 네트워크에 대한 URL을 자동으로 찾을지 여부를 나타내는 데 사용됩니다.

구문

typedef struct _WINHTTP_AUTOPROXY_OPTIONS {
  DWORD   dwFlags;
  DWORD   dwAutoDetectFlags;
  LPCWSTR lpszAutoConfigUrl;
  LPVOID  lpvReserved;
  DWORD   dwReserved;
  BOOL    fAutoLogonIfChallenged;
} WINHTTP_AUTOPROXY_OPTIONS, *PWINHTTP_AUTOPROXY_OPTIONS;

멤버

dwFlags

PAC 파일을 가져오는 데 메커니즘을 사용해야 합니다.

값 의미
WINHTTP_AUTOPROXY_ALLOW_AUTOCONFIG
 자동 구성 URL을 통해 프록시 검색을 사용하도록 설정합니다.
 
참고 이 플래그에 대한 지원은 Windows 10 버전 1703(10.0; 빌드 15063).
 
WINHTTP_AUTOPROXY_ALLOW_CM
 연결 관리자를 통해 프록시 검색을 사용하도록 설정합니다.
 
참고 이 플래그에 대한 지원은 Windows 10 버전 1703(10.0; 빌드 15063).
 
WINHTTP_AUTOPROXY_ALLOW_STATIC
 정적 구성을 통해 프록시 검색을 사용하도록 설정합니다.
 
참고 이 플래그에 대한 지원은 Windows 10 버전 1703(10.0; 빌드 15063).
 
WINHTTP_AUTOPROXY_AUTO_DETECT
 로컬 네트워크에 대한 DHCP 및 DNS 쿼리를 모두 사용하여 PAC 파일의 URL을 자동으로 검색하려고 시도합니다.
WINHTTP_AUTOPROXY_CONFIG_URL
 WINHTTP_AUTOPROXY_OPTIONS 구조의 lpszAutoConfigUrl 에 지정된 URL에서 PAC 파일을 다운로드 합니다.
WINHTTP_AUTOPROXY_HOST_KEEPCASE
 PAC 스크립트에 전달된 호스트 이름의 대/소문자를 유지 관리합니다. 기본 동작입니다.
WINHTTP_AUTOPROXY_HOST_LOWERCASE
 호스트 이름을 PAC 스크립트에 전달하기 전에 소문자로 변환합니다.
WINHTTP_AUTOPROXY_NO_CACHE_CLIENT
 현재 프로세스에서 스크립트 실행 결과의 프록시 캐시에 대한 호스트 쿼리를 사용하지 않도록 설정합니다.
WINHTTP_AUTOPROXY_NO_CACHE_SVC
 autoproxy 서비스에서 스크립트 실행 결과의 프록시 캐시에 대한 호스트 쿼리를 사용하지 않도록 설정합니다.
WINHTTP_AUTOPROXY_NO_DIRECTACCESS
 이 요청에 대한 직접 액세스 프록시 설정 쿼리를 사용하지 않도록 설정합니다.
WINHTTP_AUTOPROXY_RUN_INPROCESS
 사용 가능한 경우 Out-of-process WinHTTP AutoProxy Service를 위임하는 대신 WPAD(웹 프록시 자동 검색) 프로토콜 in-process를 실행합니다. 이 플래그는 다른 플래그 중 하나와 결합되어야 합니다.

이 옵션은 WinHttpGetProxyForUrlEx에 전달될 때 적용되지 않습니다.

참고 이 플래그는 더 이상 사용되지 않습니다.
 
WINHTTP_AUTOPROXY_RUN_OUTPROCESS_ONLY
 기본적으로 WinHTTP는 프로세스 내 프록시를 자동으로 검색하도록 대체하도록 구성됩니다. out-of-process 검색이 실패하는 경우 이 대체 동작이 바람직하지 않은 경우 이 플래그를 사용하여 사용하지 않도록 설정할 수 있습니다.

이 옵션은 WinHttpGetProxyForUrlEx에 전달될 때 적용되지 않습니다.

참고 이 플래그는 Windows Server 2003에서만 사용할 수 있습니다.
 
WINHTTP_AUTOPROXY_SORT_RESULTS
가장 빠른 프록시를 먼저 배치하는 추론에 따라 프록시 결과를 정렬합니다.

dwAutoDetectFlags

dwFlags에 WINHTTP_AUTOPROXY_AUTO_DETECT 플래그가 포함된 경우 dwAutoDetectFlags는 PAC 파일을 찾는 데 사용할 프로토콜을 지정합니다. DHCP와 DNS 자동 검색 플래그가 모두 지정된 경우 DHCP가 먼저 사용됩니다. DHCP를 사용하여 PAC URL이 검색되지 않으면 DNS가 사용됩니다.

dwFlags에 WINHTTP_AUTOPROXY_AUTO_DETECT 플래그가 포함되어 있지 않으면 dwAutoDetectFlags는 0이어야 합니다.

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

lpszAutoConfigUrl

dwFlags에 WINHTTP_AUTOPROXY_CONFIG_URL 플래그가 포함된 경우 lpszAutoConfigUrl은 PAC(프록시 자동 구성) 파일의 URL을 포함하는 null로 끝나는 유니코드 문자열을 가리킵니다.

dwFlags에 WINHTTP_AUTOPROXY_CONFIG_URL 플래그가 포함되지 않은 경우 lpszAutoConfigUrl은 NULL이어야 합니다.

lpvReserved

나중에 사용하도록 예약됨; 은 NULL이어야 합니다.

dwReserved

나중에 사용하도록 예약되어 있습니다. 0이어야 합니다.

fAutoLogonIfChallenged

WinHTTP가 PAC 파일을 요청할 때 NTLM 또는 인증 협상 챌린지에 대한 응답으로 클라이언트의 도메인 자격 증명을 자동으로 보낼지 여부를 지정합니다.

이 플래그가 TRUE이면 인증 챌린지에 대한 응답으로 자격 증명이 자동으로 전송되어야 합니다. 이 플래그가 FALSE이고 PAC 파일을 다운로드하는 데 인증이 필요한 경우 WinHttpGetProxyForUrl 함수가 실패합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP, Windows 2000 Professional SP3 포함 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003, Windows 2000 Server SP3 [데스크톱 앱만 해당]
머리글 winhttp.h

추가 정보

WinHTTP 버전