IBackgroundCopyJobHttpOptions::SetSecurityFlags 메서드(bits2_5.h)
인증서 해지 목록이 선택되고 특정 인증서 오류가 무시되는지 여부와 서버가 HTTP 요청을 리디렉션할 때 사용할 정책을 결정하는 HTTP에 대한 플래그를 설정합니다.
구문
HRESULT SetSecurityFlags(
[in] ULONG Flags
);
매개 변수
[in] Flags
서버에 연결할 때 무시할 오류를 나타내는 HTTP 보안 플래그입니다. 다음 플래그 중 하나 이상을 설정할 수 있습니다.
반환 값
다음 표에서는 가능한 반환 값 중 일부를 나열합니다.
| 반환 코드 | 설명 |
|---|---|
|
헤더를 성공적으로 검색했습니다. |
|
플래그 값은 지원되지 않습니다. |
설명
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)
피어 캐싱을 사용하도록 설정하고 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 |