共用方式為

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結合。

傳回值

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

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

備註

如果要求 CRL 檢查，BITS 會針對指定 HTTPS 通訊協定的作業中的所有檔案執行檢查。 在檔案開始傳輸之前，會針對每個檔案進行檢查。 如果您在 BITS 部分下載檔案之後將此值設定為 TRUE ，BITS 會重新排程作業，然後再次開始下載檔案。 已下載的檔案不會受到影響。

如果 CRL 為最新狀態，BITS 會使用本機電腦上的 CRL;否則，BITS 會從憑證授權單位單位下載 CRL， (CA) 簽署憑證。

如果發生下列錯誤，作業就會進入嚴重錯誤狀態。

錯誤碼 描述
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 下載檔案，對等在對等快取中找不到檔案，最後會從源伺服器下載檔案。

如果您指定 ，並從 下載檔案

請注意，呼叫 IBackgroundCopyJob3：：ReplaceRemotePrefix 方法時，設定BG_HTTP_REDIRECT_POLICY_ALLOW_REPORT可能會影響結果。 如果伺服器重新導向您的要求，BITS 已將原始 URL 變更為最終重新導向的 URL，因此呼叫 ReplaceRemotePrefix 方法時，找不到具有原始 URL 的檔案。

規格需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 bits2_5.h (包含 Bits.h)
程式庫 Bits.lib

另請參閱

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions：：GetSecurityFlags