다음을 통해 공유

IBackgroundCopyJobHttpOptions::SetSecurityFlags 메서드(bits2_5.h)

  • 아티클

인증서 해지 목록이 선택되고 특정 인증서 오류가 무시되는지 여부와 서버가 HTTP 요청을 리디렉션할 때 사용할 정책을 결정하는 HTTP에 대한 플래그를 설정합니다.

구문

HRESULT SetSecurityFlags(
  [in] ULONG Flags
);

매개 변수

[in] Flags

서버에 연결할 때 무시할 오류를 나타내는 HTTP 보안 플래그입니다. 다음 플래그 중 하나 이상을 설정할 수 있습니다.

값 의미
BG_SSL_ENABLE_CRL_CHECK
0x0001
 CRL(인증서 해지 목록)을 확인하여 서버 인증서가 해지되지 않은지 확인합니다.
BG_SSL_IGNORE_CERT_CN_INVALID
0x0002
 서버의 인증서 호스트 이름이 요청의 호스트 이름과 일치하지 않을 때 발생하는 오류를 무시합니다.
BG_SSL_IGNORE_CERT_DATE_INVALID
0x0004
 만료된 인증서로 인한 오류를 무시합니다.
BG_SSL_IGNORE_UNKNOWN_CA
0x0008
 알 수 없는 CA(인증 기관)와 관련된 오류를 무시합니다.
BG_SSL_IGNORE_CERT_WRONG_USAGE
0x0010
 인증서 사용과 관련된 오류를 무시합니다.
BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT
0x0000
 서버에서 요청을 다른 서버로 리디렉션할 수 있습니다. 이것이 기본값입니다.
BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT
0x0100
 서버에서 요청을 다른 서버로 리디렉션할 수 있습니다. BITS는 최종 URL로 원격 이름을 업데이트합니다.
BG_HTTP_REDIRECT_POLICY_DISALLOW
0x0200
 서버가 요청을 다른 서버로 리디렉션할 때 작업이 심각한 오류 상태에 놓입니다. BITS는 원격 이름을 리디렉션된 URL로 업데이트합니다.
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
 보안 플래그 값과 함께 사용할 수 있는 비트 마스크는 적용되는 리디렉션 정책을 결정합니다. 플래그 ALLOW_HTTPS_TO_HTTP 포함되지 않습니다.
BG_HTTP_REDIRECT_POLICY_ALLOW_HTTPS_TO_HTTP
0x0800
 서버에서 HTTPS 요청을 HTTP URL로 리디렉션할 수 있습니다.

이 플래그를 BG_HTTP_REDIRECT_POLICY_ALLOW_SILENT 및 BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT 결합할 수 있습니다.

반환 값

다음 표에서는 가능한 반환 값 중 일부를 나열합니다.

반환 코드 설명
S_OK
 헤더를 성공적으로 검색했습니다.
E_NOTIMPL
 플래그 값은 지원되지 않습니다.

설명

CRL 검사가 요청되면 BITS는 HTTPS 프로토콜을 지정하는 작업의 모든 파일에 대해 검사 수행합니다. 파일 전송을 시작하기 전에 각 파일에 대해 검사 만들어집니다. BITS가 파일을 부분적으로 다운로드한 후 이 값을 TRUE 로 설정하면 BITS는 작업 일정을 조정하고 파일 다운로드를 다시 시작합니다. 이미 다운로드한 파일은 영향을 받지 않습니다.

BITS는 CRL이 최신 상태인 경우 로컬 컴퓨터에서 CRL을 사용합니다. 그렇지 않으면 BITS는 인증서에 서명한 CA(인증 기관)에서 CRL을 다운로드합니다.

다음 오류가 발생하면 작업이 심각한 오류 상태로 전환됩니다.

오류 코드 Description
ERROR_WINHTTP_SECURE_CERT_REV_FAILED 인증서 서버가 오프라인 상태이거나 CRL을 다운로드할 수 없으므로 CRL 검사를 요청할 수 없습니다.
ERROR_WINHTTP_SECURE_CERT_REVOKED 인증서가 취소되었습니다.
 

리디렉션 정책은 다운로드 작업의 모든 파일에 적용됩니다(업로드 작업에는 정책이 적용되지 않음).

BITS 3.0 이전: 리디렉션 정책은 지원되지 않습니다.

정책이 BG_HTTP_REDIRECT_POLICY_DISALLOW 서버가 요청을 리디렉션하는 경우 작업은 다음 오류 코드 중 하나를 사용하여 심각한 오류 상태에 놓입니다. 오류 코드에 대한 설명은 HTTP 상태 코드를 참조하세요.

  • HRESULT_FROM_WIN32(HTTP_STATUS_AMBIGUOUS)
  • HRESULT_FROM_WIN32(HTTP_STATUS_MOVED)
  • HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT)
  • HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_METHOD)
  • HRESULT_FROM_WIN32(HTTP_STATUS_REDIRECT_KEEP_VERB)
BITS는 HTTP 또는 HTTP에서 SMB로의 리디렉션을 지원하지 않습니다.

피어 캐싱을 사용하도록 설정하고 BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT 지정하면 파일이 최종 리디렉션된 URL을 사용하여 캐시에 저장됩니다. 피어가 원래 URL을 사용하여 파일을 다운로드하려고 하면 피어가 피어의 캐시에서 파일을 찾지 못하고 원본 서버에서 파일을 다운로드하게 됩니다.

를 지정하고 파일이 에서 다운로드되는 경우

설정 BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT IBackgroundCopyJob3::ReplaceRemotePrefix 메서드를 호출할 때 결과에 영향을 줄 수 있습니다. 서버가 요청을 리디렉션한 경우 BITS는 이미 원래 URL을 최종 리디렉션된 URL로 변경했으므로 ReplaceRemotePrefix 메서드를 호출하면 원래 URL이 있는 파일을 찾을 수 없습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista
지원되는 최소 서버 Windows Server 2008
대상 플랫폼 Windows
헤더 bits2_5.h(Bits.h 포함)
라이브러리 Bits.lib

추가 정보

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::GetSecurityFlags