옵션 플래그(Wininet.h)

다음 옵션 플래그는 InternetQueryOption 및 InternetSetOption 함수와 함께 사용됩니다. 모든 유효한 옵션 플래그의 값은 INTERNET_FIRST_OPTION 보다 크거나 같으며 INTERNET_LAST_OPTION 보다 작거나 같습니다.

INTERNET_OPTION_ALTER_IDENTITY

80

구현되지 않음

INTERNET_OPTION_ASYNC

30

구현되지 않았습니다.

INTERNET_OPTION_ASYNC_ID

15

구현되지 않았습니다.

INTERNET_OPTION_ASYNC_PRIORITY

16

구현되지 않았습니다.

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

시스템이 최신 콘텐츠에 대해 네트워크를 검사 최신 버전이 발견되면 편집된 캐시 항목을 덮어쓸지 여부를 결정하는 부울 값을 설정하거나 검색합니다. True로 설정하면 시스템은 네트워크에서 최신 콘텐츠를 확인하고 편집된 캐시 항목을 최신 버전으로 덮어씁니다. 기본값은 False로, 네트워크를 확인하지 않고 편집된 캐시 항목을 사용해야 했음을 나타냅니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. Microsoft 인터넷 Explorer 5 이상에서만 유효합니다.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

더 이상 지원되지 않습니다.

INTERNET_OPTION_CACHE_TIMESTAMPS

69

인터넷 캐시에 저장된 리소스에서 LastModified 시간 및 만료 시간을 포함하는 INTERNET_CACHE_TIMESTAMPS 구조를 검색합니다. 이 값은 InternetQueryOption에서 사용됩니다.

INTERNET_OPTION_CALLBACK

1

이 핸들에 대해 정의된 콜백 함수의 주소를 설정하거나 검색합니다. 이 옵션은 모든 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_CALLBACK_FILTER

54

구현되지 않았습니다.

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

이 플래그는 InternetQueryOption에서 지원되지 않습니다. lpBuffer 매개 변수는 CERT_CONTEXT 포인터가 아닌 CERT_CONTEXT 구조체에 대한 포인터여야 합니다. 애플리케이션이 ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED 수신하는 경우 요청을 다시 시도하기 전에 InternetErrorDlg를 호출하거나 InternetSetOption을 사용하여 인증서를 제공해야 합니다. 그런 다음, 전달된 인증서 컨텍스트를 애플리케이션에서 독립적으로 해제할 수 있도록 CertDuplicateCertificateContext가 호출됩니다.

INTERNET_OPTION_CODEPAGE

68

기본적으로 유니코드 URL의 호스트 또는 기관 부분은 IDN 사양에 따라 인코딩됩니다. IDN을 사용하지 않도록 설정한 경우 요청 또는 연결 핸들에서 이 옵션을 설정하면 URL의 호스트 부분에 대한 코드 페이지 인코딩 체계가 지정됩니다. InternetSetOption 호출의 lpBuffer 매개 변수에는 원하는 DBCS 코드 페이지가 포함되어 있습니다. lpBuffer에 코드 페이지가 지정되지 않은 경우 WinINet은 기본 시스템 코드 페이지(CP_ACP)를 사용합니다. 참고: IDN을 사용하지 않도록 설정하지 않은 경우 이 옵션은 무시됩니다. IDN을 사용하지 않도록 설정하는 방법에 대한 자세한 내용은 INTERNET_OPTION_IDN 옵션을 참조하세요.

WINDOWS XP SP2 및 Windows Server 2003 SP1 사용: 이 플래그는 지원되지 않습니다.

버전: 인터넷 Explorer 7.0이 필요합니다.

INTERNET_OPTION_CODEPAGE_PATH

100

기본적으로 URL의 경로 부분은 UTF8로 인코딩됩니다. WinINet API는 상위 비트 문자에서 이스케이프 문자(%) 인코딩을 수행합니다. 요청 또는 연결 핸들에서 이 옵션을 설정하면 UTF8 인코딩이 비활성화되고 특정 코드 페이지가 설정됩니다. InternetSetOption 호출의 lpBuffer 매개 변수에는 경로에 대해 원하는 DBCS 코드 페이지가 포함됩니다. lpBuffer에 코드 페이지가 지정되지 않은 경우 WinINet은 기본 CP_UTF8 사용합니다.

WINDOWS XP SP2 및 Windows Server 2003 SP1 사용: 이 플래그는 지원되지 않습니다.

버전: 인터넷 Explorer 7.0이 필요합니다.

INTERNET_OPTION_CODEPAGE_EXTRA

101

기본적으로 URL의 경로 부분은 기본 시스템 코드 페이지(CP_ACP)입니다. 이스케이프 문자(%) 변환은 추가 부분에서 수행되지 않습니다. 요청 또는 연결 핸들에서 이 옵션을 설정하면 CP_ACP 인코딩이 비활성화됩니다. InternetSetOption 호출의 lpBuffer 매개 변수에는 URL의 추가 부분에 대해 원하는 DBCS 코드 페이지가 포함됩니다. lpBuffer에 코드 페이지가 지정되지 않은 경우 WinINet은 기본 시스템 코드 페이지(CP_ACP)를 사용합니다.

WINDOWS XP SP2 및 Windows Server 2003 SP1 사용: 이 플래그는 지원되지 않습니다.

버전: 인터넷 Explorer 7.0이 필요합니다.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

WinInet가 서버의 제공된 Content-Encoding을 압축 해제한 요청의 경우 응답 본문의 서버 보고 Content-Length를 ULONGLONG으로 검색합니다. Windows 10 버전 1507 이상에서 지원됩니다.

INTERNET_OPTION_CONNECT_BACKOFF

4

구현되지 않았습니다.

INTERNET_OPTION_CONNECT_RETRIES

3

WinINet이 resolve 호스트에 연결하려고 시도하는 횟수를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. IP 주소당 한 번만 시도합니다. 예를 들어 IP 주소가 10개이고 INTERNET_OPTION_CONNECT_RETRIES 7로 설정된 멀티홈 호스트에 연결을 시도하는 경우 WinINet은 resolve 처음 7개의 IP 주소에만 연결하려고 시도합니다. 반대로 동일한 10개의 IP 주소 집합을 감안할 때 INTERNET_OPTION_CONNECT_RETRIES 20으로 설정된 경우 WinINet은 10개 각각을 한 번만 시도합니다. 호스트에 IP 주소가 하나만 있고 첫 번째 연결 시도가 실패하는 경우 더 이상 시도하지 않습니다. 지정된 시도 횟수 후에도 연결 시도가 실패하면 요청이 취소됩니다. INTERNET_OPTION_CONNECT_RETRIES 기본값은 5번의 시도입니다. 이 옵션은 NULL 핸들을 포함하여 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_CONNECT_TIME

55

구현되지 않았습니다.

INTERNET_OPTION_CONNECT_TIMEOUT

2

인터넷 연결 요청에 사용할 시간 제한 값(밀리초)을 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. 이 옵션을 무한(0xFFFFFFFF)으로 설정하면 이 타이머가 비활성화됩니다.

연결 요청이 이 시간 제한 값보다 오래 걸리면 요청이 취소됩니다. 단일 호스트(다중 홈 호스트)의 여러 IP 주소에 연결하려고 하면 모든 IP 주소에 대한 시간 제한은 누적됩니다. 이 옵션은 NULL 핸들을 비롯한 모든 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_CONNECTED_STATE

50

연결된 상태를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_CONTEXT_VALUE

45

이 HINTERNET 핸들과 연결된 컨텍스트 값의 주소를 포함하는 DWORD_PTR 설정하거나 검색합니다. 이 옵션은 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. 이전에는 컨텍스트 값을 lpBuffer 포인터에 저장된 주소로 설정했습니다. 버퍼에 저장된 값이 사용되고 INTERNET_OPTION_CONTEXT_VALUE 플래그에 새 값이 할당되도록 수정되었습니다. 이전 동작에 대해 작성된 애플리케이션이 계속 지원되도록 이전 값 10이 유지되었습니다.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

INTERNET_OPTION_RECEIVE_TIMEOUT 동일합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

INTERNET_OPTION_SEND_TIMEOUT 동일합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

FTP 트랜잭션의 데이터 채널에 대한 요청에 대한 응답을 수신하기 위해 시간 제한 값(밀리초)이 포함된 부호 없는 긴 정수 값을 설정하거나 검색합니다. 응답이 이 제한 시간 값보다 오래 걸리면 요청이 취소됩니다. 이 옵션은 NULL 핸들을 비롯한 모든 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

이 플래그는 HTTP 기능에 영향을 주지 않습니다.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

FTP 트랜잭션의 데이터 채널에 대한 요청을 보낼 시간 제한 값을 포함하는 부호 없는 긴 정수 값(밀리초)을 설정하거나 검색합니다. 보내기가 이 제한 시간 값보다 오래 걸리면 보내기가 취소됩니다. 이 옵션은 NULL 핸들을 비롯한 모든 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

이 플래그는 HTTP 기능에 영향을 주지 않습니다.

INTERNET_OPTION_DATAFILE_NAME

33

다운로드한 엔터티를 지원하는 파일의 이름을 포함하는 문자열 값을 검색합니다. 이 플래그는 InternetOpenUrl, FtpOpenFile, GopherOpenFile 또는 HttpOpenRequest 가 완료된 후에 유효합니다. 이 옵션은 InternetQueryOption에서만 쿼리할 수 있습니다.

INTERNET_OPTION_DATAFILE_EXT

96

다운로드한 엔터티를 지원하는 파일의 확장자를 포함하는 문자열 값을 설정합니다. InternetOpenUrl, FtpOpenFile, GopherOpenFile 또는 HttpOpenRequest를 호출하기 전에 이 플래그를 설정해야 합니다. 이 옵션은 InternetSetOption에서만 설정할 수 있습니다.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

지정된 HTTP 요청에 대한 데이터를 포함하는 INTERNET_DIAGNOSTIC_SOCKET_INFO 구조를 검색합니다. 이 플래그는 InternetQueryOption에서 사용됩니다.

Windows 7: 이 옵션은 더 이상 지원되지 않습니다.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

시스템에서 다이제스트 인증 SSPI 패키지를 로그오프하여 프로세스에 대해 만든 모든 자격 증명을 제거합니다. 이 옵션에는 버퍼가 필요하지 않습니다. InternetSetOption에서 사용됩니다.

INTERNET_OPTION_DISABLE_AUTODIAL

70

구현되지 않았습니다.

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

구현되지 않았습니다.

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

허용되는 고급 HTTP 버전의 DWORD 비트 마스크를 설정합니다. 모든 핸들 형식에서 설정할 수 있습니다. 가능한 값은 다음과 같습니다.

• HTTP_PROTOCOL_FLAG_HTTP2(0x2). Windows 10 버전 1507 이상에서 지원됩니다.

이 옵션을 사용하여 레거시 버전의 HTTP(1.1 이상)를 사용하지 않도록 설정할 수 없습니다. 기본값은 0x0. Windows 10 버전 1507 이상에서 지원됩니다.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

요청 핸들에서 지정된 요청에 대해 WinInet 캐시에서 리디렉션이 반환되는지 여부를 제어하는 부울을 설정합니다. 기본값은 FALSE입니다. Windows 8 이상에서 지원됩니다.

INTERNET_OPTION_ENCODE_EXTRA

155

쿼리 문자열에서 ASCII가 아닌 문자를 백분율로 인코딩해야 하는지 여부를 나타내는 BOOL을 가져오고 설정합니다. 기본값은 FALSE입니다. Windows 8.1 이상에서 지원됩니다.

INTERNET_OPTION_END_BROWSER_SESSION

42

하드 디스크 드라이브의 암호 캐시에서 사용하지 않는 항목을 플러시합니다. 또한 동기화 모드가 세션당 한 번일 때 사용되는 캐시 시간을 다시 설정합니다. 이 옵션에는 버퍼가 필요하지 않습니다. InternetSetOption에서 사용됩니다.

INTERNET_OPTION_ERROR_MASK

62

클라이언트 애플리케이션에서 처리할 수 있는 오류 마스크를 포함하는 부호 없는 긴 정수 값을 설정합니다. 다음 값의 조합일 수 있습니다.

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

모든 인증서 오류가 동일한 오류 반환을 사용하여 보고되어야 하며, 즉 ERROR_INTERNET_SEC_CERT_ERRORS 나타냅니다. 이 플래그가 설정된 경우 사용자가 문제를 설명하는 친숙한 대화 상자에 응답할 수 있도록 ERROR_INTERNET_SEC_CERT_ERRORS 오류가 발생하면 InternetErrorDlg를 호출합니다.

주의

사용자에게 이 오류를 알리지 않으면 잠재적인 스푸핑 공격에 노출됩니다.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

클라이언트 애플리케이션이 ERROR_INTERNET_INSERT_CDROM 오류 코드를 처리할 수 있음을 나타냅니다.

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

클라이언트 애플리케이션이 ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY 오류 코드를 처리할 수 있음을 나타냅니다.

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

구현되지 않았습니다.

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

요청에 적용되는 엔터프라이즈 ID(참조 https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx)를 포함하는 PWSTR을 설정합니다. Windows 10 버전 1507 이상에서 지원됩니다.

INTERNET_OPTION_EXTENDED_ERROR

24

이 스레드 컨텍스트에서 마지막으로 반환된 ERROR_INTERNET_ 오류 메시지에 매핑된 Winsock 오류 코드가 포함된 부호 없는 긴 정수 값을 검색합니다. 이 옵션은 InternetQueryOption의 NULLHINTERNET 핸들에서 사용됩니다.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

캐시에서 리소스 복사본을 확인하기 전에 시스템이 네트워크 요청에 대한 응답을 기다려야 하는 시간을 포함하는 a1n 부호 없는 긴 정수 값을 설정하거나 검색합니다. 네트워크 요청이 지정된 시간보다 오래 걸리고 요청된 리소스를 캐시에서 사용할 수 있는 경우 리소스는 캐시에서 검색됩니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_HANDLE_TYPE

9

전달된 HINTERNET 핸들의 형식을 포함하는 부호 없는 긴 정수 값을 검색합니다. 이는 HINTERNET 핸들의 InternetQueryOption에서 사용됩니다. 가능한 반환 값은 다음과 같습니다.

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157

WinInet가 서버의 HSTS(HTTP Strict Transport Security) 지시문을 따라야 하는지 여부를 나타내는 BOOL을 가져오고 설정합니다. 사용하도록 설정하면 WinInet에서 캐시한 HSTS 정책이 있는 도메인에 대한 https:// 체계화된 요청이 일치하는 https:// URL로 리디렉션됩니다. 기본값은 FALSE입니다. Windows 8.1 이상에서 지원됩니다.

INTERNET_OPTION_HTTP_DECODING

65

WinINet이 gzip에 대한 디코딩을 수행하고 인코딩 체계를 디코딩할 수 있도록 합니다. 자세한 내용은 콘텐츠 인코딩을 참조하세요.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

지정된 요청에 사용된 고급 HTTP 버전을 나타내는 DWORD를 가져옵니다. 가능한 값은 다음과 같습니다.

• HTTP_PROTOCOL_FLAG_HTTP2(0x2). Windows 10 버전 1507 이상에서 지원됩니다.

0x0 HTTP/1.1 이하를 나타냅니다. 어떤 레거시 버전이 사용되었는지에 대해 더 많은 정밀도가 필요한 경우 INTERNET_OPTION_HTTP_VERSION 참조하세요. Windows 10 버전 1507 이상에서 지원됩니다.

INTERNET_OPTION_HTTP_VERSION

59

지원되는 HTTP 버전을 포함하는 HTTP_VERSION_INFO 구조를 설정하거나 검색합니다. NULL 핸들에서 사용해야 합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

Windows 7, Windows Server 2008 R2 이상에서는 HTTP_VERSION_INFO 구조의 dwMinorVersion 멤버 값이 인터넷 Explorer 설정에 의해 재정의됩니다. EnableHttp1_1 시스템의 인터넷 Explorer 설정된 인터넷 옵션으로 제어되는 HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE 아래의 레지스트리 값입니다. EnableHttp1_1 값의 기본값은 1입니다. EnableHttp1_1 1로 설정된 경우 1.1 미만의 HTTP 버전에 대해 HTTP_VERSION_INFO 구조가 무시됩니다.

INTERNET_OPTION_IDENTITY

78

구현되지 않았습니다.

INTERNET_OPTION_IDLE_STATE

51

구현되지 않았습니다.

INTERNET_OPTION_IDN

102

기본적으로 URL의 호스트 또는 권한 부분은 직접 및 프록시 연결 모두에 대한 IDN 사양에 따라 인코딩됩니다. 이 옵션은 요청 또는 연결 핸들에서 IDN을 사용하거나 사용하지 않도록 설정하는 데 사용할 수 있습니다. IDN을 사용하지 않도록 설정하면 WinINet은 시스템 코드 페이지를 사용하여 URL의 호스트 또는 권한 부분을 인코딩합니다. IDN 호스트 변환을 사용하지 않도록 설정하려면 InternetSetOption 호출에서 lpBuffer 매개 변수를 0으로 설정합니다. 직접 연결에서만 IDN 변환을 사용하도록 설정하려면 InternetSetOption 호출의 lpBuffer 매개 변수에 INTERNET_FLAG_IDN_DIRECT 지정합니다. 프록시 연결에서만 IDN 변환을 사용하도록 설정하려면 InternetSetOption 호출의 lpBuffer 매개 변수에 INTERNET_FLAG_IDN_PROXY 지정합니다.

WINDOWS XP SP2 및 Windows Server 2003 SP1 사용: 이 플래그는 지원되지 않습니다.

버전: 인터넷 Explorer 7.0이 필요합니다.

INTERNET_OPTION_IGNORE_OFFLINE

77

지정된 요청 핸들에 대해 전역 오프라인 플래그를 무시할지 여부를 설정하거나 검색합니다. 이 옵션에는 버퍼가 필요하지 않습니다. 이는 요청 핸들이 있는 InternetQueryOption 및 InternetSetOption 에서 사용됩니다. 이 옵션은 인터넷 Explorer 5 이상에서만 유효합니다.

INTERNET_OPTION_KEEP_CONNECTION

22

구현되지 않았습니다.

INTERNET_OPTION_LISTEN_TIMEOUT

11

구현되지 않았습니다.

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

HTTP/1.0 서버당 허용되는 최대 연결 수를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. 이 옵션은 인터넷 Explorer 5 이상에서만 유효합니다.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

CERN 프록시당 허용되는 최대 연결 수를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. 이 옵션을 설정하거나 검색하면 hInternet 매개 변수를 null 핸들 값으로 설정해야 합니다. null 핸들 값은 옵션을 설정하거나 현재 프로세스에 대해 쿼리해야 했음을 나타냅니다. 이 옵션을 사용하여 InternetSetOption 을 호출할 때 모든 기존 프록시 개체는 새 값을 받습니다. 이 값은 2~128 범위(포함)로 제한됩니다.

버전: 인터넷 Explorer 8.0이 필요합니다.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

서버당 허용되는 최대 연결 수를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. 이 옵션은 인터넷 Explorer 5 이상에서만 유효합니다.

INTERNET_OPTION_OFFLINE_MODE

26

구현되지 않았습니다.

INTERNET_OPTION_OFFLINE_SEMANTICS

52

구현되지 않았습니다.

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

안전하지 않은 것으로 처리할 약한 서명(예: SHA-1)을 옵트인합니다. 그러면 WinInet에서 CERT_CHAIN_OPT_IN_WEAK_SIGNATURE 매개 변수를 사용하여 CertGetCertificateChain을 호출하도록 지시합니다.

INTERNET_OPTION_PARENT_HANDLE

21

이 핸들에 대한 부모 핸들을 검색합니다. 이 옵션은 InternetQueryOption의 HINTERNET 핸들에서 사용할 수 있습니다.

INTERNET_OPTION_PASSWORD

29

InternetConnect에서 반환된 핸들과 연결된 암호를 포함하는 문자열 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_PER_CONNECTION_OPTION

75

특정 연결에 대한 옵션 목록을 지정하는 INTERNET_PER_CONN_OPTION_LIST 구조를 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. 이 옵션은 인터넷 Explorer 5 이상에서만 유효합니다.

참고

INTERNET_OPTION_PER_CONNECTION_OPTIONInternetSetOption 호출에서 NULL 핸들을 사용하는 경우 시스템 전체에서 설정을 변경합니다. 전역 프록시 설정을 새로 고치려면 INTERNET_OPTION_REFRESH 옵션 플래그를 사용하여 InternetSetOption을 호출해야 합니다.

참고

인터넷 Explorer 5 이상에서 전역 설정에 영향을 주지 않고 전체 프로세스에 대한 프록시 정보를 변경하려면 InternetOpen에서 반환되는 핸들에서 이 옵션을 사용합니다. 다음 코드 예제에서는 HINTERNET 핸들이 닫혀 있고 요청에서 사용되지 않더라도 전체 프로세스의 프록시를 변경합니다.

INTERNET_OPTION_POLICY

48

구현되지 않았습니다.

INTERNET_OPTION_PROXY

38

HINTERNET 핸들이 NULL이 아닌 경우 기존 InternetOpen 핸들에 대한 프록시 데이터가 포함된 INTERNET_PROXY_INFO 구조를 설정하거나 검색합니다. HINTERNET 핸들이 NULL이면 함수는 전역 프록시 데이터를 설정하거나 쿼리합니다. 이 옵션은 InternetOpen에서 반환된 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

참고

INTERNET_OPTION_PROXY 대신 INTERNET_OPTION_PER_CONNECTION_OPTION 사용하는 것이 좋습니다.

INTERNET_OPTION_PROXY_PASSWORD

44

프록시에 액세스하는 데 사용되는 암호를 포함하는 문자열 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. 이 옵션은 InternetConnect 또는 HttpOpenRequest에서 반환된 핸들에서 설정할 수 있습니다.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

프록시 설정이 변경되었으며 새 설정으로 업데이트해야 한다는 현재 WinInet instance 경고합니다. 사용 가능한 모든 WinInet 인스턴스를 경고하려면 이 옵션을 전달할 때 InternetSetOption의 Buffer 매개 변수를 NULL로 설정하고 BufferLength를 0으로 설정합니다. 이 옵션은 InternetConnect 또는 HttpOpenRequest에서 반환된 핸들에서 설정할 수 있습니다.

INTERNET_OPTION_PROXY_USERNAME

43

프록시에 액세스하는 데 사용되는 사용자 이름을 포함하는 문자열 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. 이 옵션은 InternetConnect 또는 HttpOpenRequest에서 반환된 핸들에서 설정할 수 있습니다.

INTERNET_OPTION_READ_BUFFER_SIZE

12

읽기 버퍼의 크기를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. 이 옵션은 FtpOpenFile, FtpFindFirstFile 및 InternetConnect(FTP 세션에만 해당)에서 반환되는 HINTERNET 핸들에서 사용할 수 있습니다. 이 옵션은 InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

구현되지 않았습니다.

INTERNET_OPTION_RECEIVE_TIMEOUT

6

요청에 대한 응답을 수신하기 위해 시간 제한 값(밀리초)을 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. 응답이 이 제한 시간 값보다 오래 걸리면 요청이 취소됩니다. 이 옵션은 NULL 핸들을 포함하여 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

이 옵션은 세분화된 즉각적인 시간 제한을 나타내기 위한 것이 아닙니다. 설정된 시간 제한 값 이후 최대 6초까지 시간 제한이 발생할 것으로 예상할 수 있습니다.

FTP 트랜잭션을 참조하여 사용하는 경우 이 옵션은 컨트롤 채널을 참조합니다.

INTERNET_OPTION_REFRESH

37

프록시 데이터를 레지스트리에서 핸들에 대해 다시 읽도록 합니다. 버퍼가 필요하지 않습니다. 이 옵션은 InternetOpen에서 반환된 HINTERNET 핸들에서 사용할 수 있습니다. InternetSetOption에서 사용됩니다.

INTERNET_OPTION_REMOVE_IDENTITY

79

구현되지 않았습니다.

INTERNET_OPTION_REQUEST_FLAGS

23

진행 중인 다운로드의 상태 나타내는 특수 상태 플래그를 포함하는 부호 없는 정수 값을 검색합니다. InternetQueryOption에서 사용됩니다. INTERNET_OPTION_REQUEST_FLAGS 옵션은 다음 값 중 하나일 수 있습니다.

INTERNET_REQFLAG_ASYNC

0x00000002

구현되지 않았습니다.

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

인터넷 요청은 캐시할 수 없습니다(예: HTTPS 요청).

INTERNET_REQFLAG_FROM_CACHE

0x00000001

캐시에서 응답이 나왔습니다.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

인터넷 요청 시간이 초과되었습니다.

INTERNET_REQFLAG_NO_HEADERS

0x00000008

원래 응답에는 헤더가 없습니다.

INTERNET_REQFLAG_PASSIVE

0x00000010

구현되지 않았습니다.

INTERNET_REQFLAG_VIA_PROXY

0x00000004

프록시를 통해 요청이 이루어졌습니다.

INTERNET_OPTION_REQUEST_PRIORITY

58

HTTP 핸들에서 연결을 위해 경쟁하는 요청의 우선 순위를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

프로세스에 대한 새 캐시 세션을 시작합니다. 버퍼가 필요하지 않습니다. InternetSetOption에서 사용됩니다. 이 옵션은 내부 전용으로 예약되어 있습니다.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

보조 캐시 키가 포함된 문자열 값을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다. 이 옵션은 내부 전용으로 예약되어 있습니다.

INTERNET_OPTION_SECURITY_CERTIFICATE

35

SSL/PCT(Secure Sockets Layer/Private Communications Technology) 서버에 대한 인증서를 형식이 지정된 문자열로 검색합니다. InternetQueryOption에서 사용됩니다.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

SSL/PCT 서버의 인증서를 INTERNET_CERTIFICATE_INFO 구조로 검색합니다. InternetQueryOption에서 사용됩니다.

INTERNET_OPTION_SECURITY_FLAGS

31

핸들의 보안 플래그를 포함하는 부호 없는 긴 정수 값을 검색합니다. 이 옵션은 InternetQueryOption에서 사용됩니다. 다음 값의 조합일 수 있습니다.

SECURITY_FLAG_128BIT

0x20000000

기본 설정 값 SECURITY_FLAG_STRENGTH_STRONG 동일합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_40BIT

0x10000000

기본 설정 값 SECURITY_FLAG_STRENGTH_WEAK 동일합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_56BIT

0x40000000

SECURITY_FLAG_STRENGTH_MEDIUM 기본 설정 값과 동일합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_FORTEZZA

0x08000000

Fortezza가 지정된 연결에 대한 비밀, 인증 및/또는 무결성을 제공하는 데 사용되었음을 나타냅니다.

SECURITY_FLAG_IETFSSL4

0x00000020

구현되지 않았습니다.

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

ERROR_INTERNET_SEC_CERT_CN_INVALID 오류 메시지를 무시합니다.

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

ERROR_INTERNET_SEC_CERT_DATE_INVALID 오류 메시지를 무시합니다.

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR 오류 메시지를 무시합니다.

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR 오류 메시지를 무시합니다.

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

인증서 해지 문제를 무시합니다.

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

알 수 없는 인증 기관 문제를 무시합니다.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

약한 인증서 서명 문제를 무시합니다.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

잘못된 사용 문제를 무시합니다.

SECURITY_FLAG_NORMALBITNESS

0x10000000

SECURITY_FLAG_STRENGTH_WEAK 값과 동일합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_PCT

0x00000008

구현되지 않았습니다.

SECURITY_FLAG_PCT4

0x00000010

구현되지 않았습니다.

SECURITY_FLAG_SECURE

0x00000001

보안 전송을 사용합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_SSL

0x00000002

구현되지 않았습니다.

SECURITY_FLAG_SSL3

0x00000004

구현되지 않았습니다.

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

중간(56비트) 암호화를 사용합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

강력한(128비트) 암호화를 사용합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

약한(40비트) 암호화를 사용합니다. InternetQueryOption 호출에서만 반환됩니다.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

암호화에 사용되는 비트 크기를 알 수 없습니다. InternetQueryOption 호출에서만 반환됩니다.

이러한 방식으로 검색된 데이터는 보안 수준을 더 이상 변경할 수 없는 발생한 트랜잭션과 관련이 있습니다.

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

암호화 키의 비트 크기를 포함하는 부호 없는 긴 정수 값을 검색합니다. 숫자가 클수록 사용된 암호화 강도가 커지게됩니다. InternetQueryOption에서 사용됩니다. 이러한 방식으로 검색된 데이터는 보안 수준을 더 이상 변경할 수 없는 이미 발생한 트랜잭션과 관련이 있습니다.

INTERNET_OPTION_SEND_THROUGHPUT

56

구현되지 않았습니다.

INTERNET_OPTION_SEND_TIMEOUT

5

요청을 보낼 제한 시간 값이 포함된 부호 없는 정수 값을 밀리초 단위로 설정하거나 검색합니다. 보내기가 이 제한 시간 값보다 오래 걸리면 보내기가 취소됩니다. 이 옵션은 NULL 핸들을 비롯한 모든 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

FTP 트랜잭션을 참조하여 사용하는 경우 이 옵션은 컨트롤 채널을 참조합니다.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

서버의 인증서 체인 컨텍스트를 중복된 PCCERT_CHAIN_CONTEXT 검색합니다. 이 중복된 컨텍스트를 PCCERT_CHAIN_CONTEXT 사용하는 Crypto API 함수에 전달할 수 있습니다. 인증서 체인 컨텍스트를 완료하면 반환된 PCCERT_CHAIN_CONTEXTCertFreeCertificateChain을 호출해야 합니다.

버전: 인터넷 Explorer 8.0이 필요합니다.

INTERNET_OPTION_SETTINGS_CHANGED

39

다음 InternetConnect 호출에서 설정을 확인하도록 레지스트리 설정이 변경되었음을 시스템에 알린다. InternetSetOption에서 사용됩니다.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

원본 서버에 로그온하지 않고 HTTP 프록시 서버에 자동 로그온을 수행하도록 HTTP 요청 개체를 설정합니다. 이 옵션은 프록시 서버와 원본 서버 모두에 대한 인증을 방지하는 요청 플래그 INTERNET_FLAG_NO_AUTH 다릅니다.

이 모드를 설정하면 원본 서버와 통신할 때 자격 증명 자료(이전에 제공된 사용자 이름/암호 또는 클라이언트 SSL 인증서)의 사용이 억제됩니다. 그러나 요청이 인증 프록시를 통해 전송되어야 하는 경우 WinINet은 사용자의 인트라넷 영역 설정에 따라 HTTP 프록시에 대한 자동 인증을 계속 수행합니다. 기본 인트라넷 영역 설정은 사용자의 기본 자격 증명을 사용하여 자동 로그온을 허용하는 것입니다.

모든 식별 정보를 표시하지 않도록 하기 위해 호출자는 INTERNET_OPTION_SUPPRESS_SERVER_AUTH INTERNET_FLAG_NO_COOKIES 요청 플래그와 결합해야 합니다.

이 옵션은 요청 개체가 전송되기 전에만 설정할 수 있습니다. 요청이 전송된 후 이 옵션을 설정하려고 하면 ERROR_INTERNET_INCORRECT_HANDLE_STATE 반환됩니다.

이 옵션에는 버퍼가 필요하지 않습니다. HttpOpenRequest에서 반환된 핸들에서만 InternetSetOption에서 사용됩니다.

버전: 인터넷 Explorer 8.0 이상이 필요합니다.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

프로세스 전체에서 동작을 표시하지 않는 데 사용되는 범용 옵션입니다. 함수의 lpBuffer 매개 변수는 표시하지 않을 특정 동작을 포함하는 DWORD에 대한 포인터여야 합니다. InternetQueryOption을 사용하여 이 옵션을 쿼리할 수 없습니다. 허용되는 값은 다음과 같습니다.

INTERNET_SUPPRESS_RESET_ALL

0

모든 억제를 사용하지 않도록 설정하여 기본 및 구성된 동작을 다시 사용하도록 설정합니다. 이 옵션은 INTERNET_SUPPRESS_COOKIE_POLICY_RESET 개별적으로INTERNET_SUPPRESS_COOKIE_PERSIST_RESET 설정하는 것과 같습니다.

버전: 인터넷 Explorer 6.0 이상이 필요합니다.

INTERNET_SUPPRESS_COOKIE_POLICY

1

구성된 쿠키 정책을 무시하고 쿠키를 설정할 수 있습니다.

버전: 인터넷 Explorer 6.0 이상이 필요합니다.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

구성된 쿠키 정책에 따라 쿠키 평가를 허용하여 INTERNET_SUPPRESS_COOKIE_POLICY 표시하지 않도록 설정합니다.

버전: 인터넷 Explorer 6.0 이상이 필요합니다.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

서버에서 쿠키를 영구로 지정한 경우에도 쿠키의 지속성을 표시하지 않습니다.

버전: 인터넷 Explorer 8.0 이상이 필요합니다.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

쿠키의 지속성을 다시 사용하도록 설정하여 INTERNET_SUPPRESS_COOKIE_PERSIST 제거를 사용하지 않도록 설정합니다. 이전에 억제된 쿠키는 지속되지 않습니다.

버전: 인터넷 Explorer 8.0 이상이 필요합니다.

INTERNET_OPTION_URL

34

다운로드한 리소스의 전체 URL을 포함하는 문자열 값을 검색합니다. 원래 URL에 검색 문자열 또는 앵커와 같은 추가 데이터가 포함되어 있거나 호출이 리디렉션된 경우 반환된 URL은 원래 URL과 다릅니다. 이 옵션은 InternetOpenUrl, FtpOpenFile, GopherOpenFile 또는 HttpOpenRequest에서 반환된 HINTERNET 핸들에 유효합니다. InternetQueryOption에서 사용됩니다.

INTERNET_OPTION_USER_AGENT

41

HttpAddRequestHeaders 또는 HttpSendRequest에서 추가한 헤더로 재정의되지 않는 한 InternetOpen에서 제공하고 후속 HttpSendRequest 함수에서 사용되는 핸들에서 사용자 에이전트 문자열을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_USERNAME

28

InternetConnect에서 반환된 핸들과 연결된 사용자 이름을 포함하는 문자열을 설정하거나 검색합니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

INTERNET_OPTION_VERSION

40

Wininet.dll 버전 번호를 포함하는 INTERNET_VERSION_INFO 구조를 검색합니다. 이 옵션은 InternetQueryOption의 NULLHINTERNET 핸들에서 사용할 수 있습니다.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

쓰기 버퍼의 크기(바이트)를 포함하는 부호 없는 긴 정수 값을 설정하거나 검색합니다. 이 옵션은 FtpOpenFile 및 InternetConnect(FTP 세션에만 해당)에서 반환된 HINTERNET 핸들에서 사용할 수 있습니다. InternetQueryOption 및 InternetSetOption에서 사용됩니다.

설명

참고

WinINet은 서버 구현을 지원하지 않습니다. 또한 서비스에서 사용하면 안 됩니다. 서버 구현 또는 서비스의 경우 WinHTTP(Microsoft Windows HTTP 서비스)를 사용합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	Wininet.h; 위니네티.h