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 파일을 가져오는 데 메커니즘을 사용해야 합니다.
| 값 | 의미 |
|---|---|
|
자동 구성 URL을 통해 프록시 검색을 사용하도록 설정합니다.
참고 이 플래그에 대한 지원은 Windows 10 버전 1703(10.0; 빌드 15063). |
|
연결 관리자를 통해 프록시 검색을 사용하도록 설정합니다.
참고 이 플래그에 대한 지원은 Windows 10 버전 1703(10.0; 빌드 15063). |
|
정적 구성을 통해 프록시 검색을 사용하도록 설정합니다.
참고 이 플래그에 대한 지원은 Windows 10 버전 1703(10.0; 빌드 15063). |
|
로컬 네트워크에 대한 DHCP 및 DNS 쿼리를 모두 사용하여 PAC 파일의 URL을 자동으로 검색하려고 시도합니다. |
|
WINHTTP_AUTOPROXY_OPTIONS 구조의 lpszAutoConfigUrl 에 지정된 URL에서 PAC 파일을 다운로드 합니다. |
|
PAC 스크립트에 전달된 호스트 이름의 대/소문자를 유지 관리합니다. 기본 동작입니다. |
|
호스트 이름을 PAC 스크립트에 전달하기 전에 소문자로 변환합니다. |
|
현재 프로세스에서 스크립트 실행 결과의 프록시 캐시에 대한 호스트 쿼리를 사용하지 않도록 설정합니다. |
|
autoproxy 서비스에서 스크립트 실행 결과의 프록시 캐시에 대한 호스트 쿼리를 사용하지 않도록 설정합니다. |
|
이 요청에 대한 직접 액세스 프록시 설정 쿼리를 사용하지 않도록 설정합니다. |
|
사용 가능한 경우 Out-of-process WinHTTP AutoProxy Service를 위임하는 대신 WPAD(웹 프록시 자동 검색) 프로토콜 in-process를 실행합니다. 이 플래그는 다른 플래그 중 하나와 결합되어야 합니다.
이 옵션은 WinHttpGetProxyForUrlEx에 전달될 때 적용되지 않습니다. 참고 이 플래그는 더 이상 사용되지 않습니다.
|
|
기본적으로 WinHTTP는 프로세스 내 프록시를 자동으로 검색하도록 대체하도록 구성됩니다. out-of-process 검색이 실패하는 경우 이 대체 동작이 바람직하지 않은 경우 이 플래그를 사용하여 사용하지 않도록 설정할 수 있습니다.
이 옵션은 WinHttpGetProxyForUrlEx에 전달될 때 적용되지 않습니다. 참고 이 플래그는 Windows Server 2003에서만 사용할 수 있습니다.
|
|
가장 빠른 프록시를 먼저 배치하는 추론에 따라 프록시 결과를 정렬합니다. |
dwAutoDetectFlags
dwFlags에 WINHTTP_AUTOPROXY_AUTO_DETECT 플래그가 포함된 경우 dwAutoDetectFlags는 PAC 파일을 찾는 데 사용할 프로토콜을 지정합니다. DHCP와 DNS 자동 검색 플래그가 모두 지정된 경우 DHCP가 먼저 사용됩니다. DHCP를 사용하여 PAC URL이 검색되지 않으면 DNS가 사용됩니다.
dwFlags에 WINHTTP_AUTOPROXY_AUTO_DETECT 플래그가 포함되어 있지 않으면 dwAutoDetectFlags는 0이어야 합니다.
| 값 | 의미 |
|---|---|
|
DHCP를 사용하여 프록시 자동 구성 파일을 찾습니다. |
|
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 |