WinHttpRequestOption 열거형

아티클
06/13/2023

WinHttpRequestOption 열거형에는 현재 WinHTTP(Microsoft Windows HTTP 서비스) 세션에 대해 설정하거나 검색할 수 있는 옵션이 포함되어 있습니다.

Syntax

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

상수

WinHttpRequestOption_UserAgentString

사용자 에이전트 문자열을 포함하는 VARIANT를 설정하거나 검색합니다.

WinHttpRequestOption_URL

리소스의 URL을 포함하는 VARIANT 를 검색합니다. 이 값은 읽기 전용입니다. 이 속성을 사용하여 URL을 설정할 수 없습니다. Open 메서드가 호출될 때까지 URL을 읽을 수 없습니다. 이 옵션은 Send 메서드가 완료된 후 URL을 확인하여 리디렉션이 발생했는지 확인하는 데 유용합니다.

WinHttpRequestOption_URLCodePage

URL 문자열의 코드 페이지를 식별하는 VARIANT를 설정하거나 검색합니다. 기본값은 UTF-8 코드 페이지입니다. 코드 페이지는 Open 메서드에 전달된 유니코드 URL 문자열을 단일 바이트 문자열 표현으로 변환하는 데 사용됩니다.

WinHttpRequestOption_EscapePercentInURL

URL 문자열의 백분율 문자가 이스케이프 시퀀스로 변환되는지 여부를 나타내는 VARIANT 를 설정하거나 검색합니다. 이 옵션의 기본값은 백분율 기호를 제외한 모든 안전하지 않은 ANSI(미국 국립 표준 연구소) 문자를 이스케이프 시퀀스로 변환하는 VARIANT_TRUE .

WinHttpRequestOption_SslErrorIgnoreFlags

무시해야 하는 서버 인증서 오류를 나타내는 VARIANT 를 설정하거나 검색합니다. 다음 플래그 중 하나 이상의 조합일 수 있습니다.

Error	값
알 수 없는 CA(인증 기관) 또는 신뢰할 수 없는 루트	0x0100
잘못된 사용	0x0200
잘못된 CN(일반 이름)	0x1000
만료된 날짜 또는 인증서가 잘못되었습니다.	0x2000

WinHTTP 버전 5.1에서 이 옵션의 기본값은 0이므로 오류가 무시되지 않습니다. 이전 버전의 WinHTTP에서는 기본 설정이 0x3300 모든 서버 인증서 오류가 기본적으로 무시되었습니다.

WinHttpRequestOption_SelectCertificate

인증을 위해 서버로 전송되는 클라이언트 인증서를 지정하는 VARIANT 를 설정합니다. 이 옵션은 백슬래시로 구분된 클라이언트 인증서의 위치, 인증서 저장소 및 주체를 나타냅니다. 클라이언트 인증서를 선택하는 방법에 대한 자세한 내용은 WinHTTP의 SSL을 참조하세요.

WinHttpRequestOption_EnableRedirects

서버가 리소스의 새 위치를 지정할 때 요청이 자동으로 리디렉션되는지 여부를 나타내는 VARIANT 를 설정하거나 검색합니다. 이 옵션의 기본값은 요청이 자동으로 리디렉션됨을 나타내는 VARIANT_TRUE .

WinHttpRequestOption_UrlEscapeDisable

URL의 경로 및 쿼리 구성 요소에서 안전하지 않은 문자가 이스케이프 시퀀스로 변환되는지 여부를 나타내는 VARIANT 를 설정하거나 검색합니다. 이 옵션의 기본값은 경로 및 쿼리의 문자가 변환되도록 지정하는 VARIANT_TRUE.

WinHttpRequestOption_UrlEscapeDisableQuery

URL의 쿼리 구성 요소에서 안전하지 않은 문자가 이스케이프 시퀀스로 변환되는지 여부를 나타내는 VARIANT 를 설정하거나 검색합니다. 이 옵션의 기본값은 쿼리의 문자가 변환되도록 지정하는 VARIANT_TRUE.

WinHttpRequestOption_SecureProtocols

사용할 수 있는 보안 프로토콜을 나타내는 VARIANT 를 설정하거나 검색합니다. 이 옵션은 클라이언트에 허용되는 프로토콜을 선택합니다. 프로토콜은 SSL(Secure Sockets Layer) 핸드셰이크 중에 협상됩니다. 다음 플래그 중 하나 이상의 조합일 수 있습니다.

프로토콜	값
SSL 2.0	0x0008
SSL 3.0	0x0020
TLS(전송 계층 보안) 1.0	0x0080

이 옵션의 기본값은 SSL 2.0 또는 SSL 3.0을 사용할 수 있음을 나타내는 0x0028. 이 옵션을 0으로 설정하면 클라이언트와 서버가 허용되는 보안 프로토콜을 확인할 수 없으며 다음 보내기 로 인해 오류가 발생합니다.

WinHttpRequestOption_EnableTracing

추적이 현재 활성화되어 있는지 여부를 나타내는 VARIANT 를 설정하거나 검색합니다. 또한 WinHTTP 추적 수집을 참조하세요.

WinHttpRequestOption_RevertImpersonationOverSsl

WinHttpRequest 개체가 SSL 인증서 인증 작업 기간 동안 클라이언트 가장을 일시적으로 되돌릴지 여부를 제어합니다. WinHttpRequest 개체의 기본 설정은 TRUE입니다. 인증서 인증 작업을 수행하는 동안 가장을 유지하려면 이 옵션을 FALSE 로 설정합니다.

WinHttpRequestOption_EnableHttpsToHttpRedirects

WinHTTP에서 리디렉션을 허용하는지 여부를 제어합니다. 기본적으로 보안(https) URL에서 안전하지 않은(http) URL로 전송하는 리디렉션을 제외하고 모든 리디렉션이 자동으로 수행됩니다. HTTPS에서 HTTP 리디렉션을 사용하도록 설정하려면 이 옵션을 TRUE 로 설정합니다.

WinHttpRequestOption_EnablePassportAuthentication

Passport 인증에 대한 지원을 사용하거나 사용하지 않도록 설정합니다. 기본적으로 Passport 인증에 대한 자동 지원은 사용하지 않도록 설정됩니다. Passport 인증 지원을 사용하도록 설정하려면 이 옵션을 TRUE 로 설정합니다.

WinHttpRequestOption_MaxAutomaticRedirects

WinHTTP가 따르는 최대 리디렉션 수를 설정하거나 검색합니다. 기본값은 10입니다. 이 제한은 권한이 없는 사이트에서 많은 수의 리디렉션에 따라 WinHTTP 클라이언트가 중단되는 것을 방지합니다.