共用方式為


IBackgroundCopyJobHttpOptions::SetSecurityFlags 方法(bits2_5.h)

設定 HTTP 旗標,判斷是否檢查憑證撤銷清單及忽略某些憑證錯誤,以及伺服器重定向 HTTP 請求時的政策。

語法

HRESULT SetSecurityFlags(
  [in] ULONG Flags
);

參數

[in] Flags

HTTP 安全標誌,指示連接伺服器時應忽略的錯誤。 你可以設定以下一個或多個旗標:

價值觀 Meaning
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 更新遠端名稱並附上最終網址。
BG_HTTP_REDIRECT_POLICY_DISALLOW
0x0200
當伺服器將你的請求導向到另一台伺服器時,會將工作置於致命錯誤狀態。 BITS 更新遠端名稱並使用重定向的網址。
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
你可以用 Bitmask 搭配安全旗標值來判斷是哪個重定向政策生效。 它不包含旗幟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結合。

返回值

下表列出了一些可能的回傳值。

回傳碼 Description
S_OK
成功取得標頭。
E_NOTIMPL
旗標值不被支援。

備註

若要求 CRL 檢查,BITS 會對工作中所有指定 HTTPS 協定的檔案進行檢查。 在檔案開始傳輸前,會對每個檔案進行檢查。 如果你在 BITS 部分下載檔案後將此值設為 TRUE,BITS 會重新排程工作並重新開始下載該檔案。 已下載的檔案則不會受到影響。

BITS 在本地電腦使用 CRL,若 CRL up-to-日期;否則,BITS 會從簽署憑證的認證機構(CA)下載CRL。

若發生以下錯誤,工作將進入致命錯誤狀態。

錯誤碼 Description
ERROR_WINHTTP_SECURE_CERT_REV_FAILED 無法請求 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 下載檔案,該節點將找不到該檔案,最終會從原始伺服器下載該檔案。

如果您指定且該檔案是從

請注意,設定 BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT 可能會影響呼叫 IBackgroundCopyJob3::ReplaceRemotePrefix 方法時的結果。 如果伺服器重定向了你的請求,BITS 已經將原始網址改成最終重定向 URL,因此呼叫 ReplaceRemotePrefix 方法找不到原始 URL 的檔案。

需求

Requirement 價值觀
最低支援的用戶端 Windows Vista
支援的最低伺服器 Windows 伺服器 2008
目標平臺 窗戶
Header bits2_5.h(包含 Bits.h)
Library Bits.lib

另請參閱

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions::GetSecurityFlags