IBackgroundCopyJobHttpOptions：：GetSecurityFlags 方法 (bits2_5.h)

  • 發行項

擷取 HTTP 的旗標，判斷是否已檢查證書吊銷清單，並忽略特定憑證錯誤，以及伺服器重新導向 HTTP 要求時要使用的原則。

語法

HRESULT GetSecurityFlags(
  [out] ULONG *pFlags
);

參數

[out] pFlags

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
 當伺服器將要求重新導向至另一部伺服器時，Places 嚴重錯誤狀態的作業。 BITS 會使用重新導向的 URL 來更新遠端名稱。
BG_HTTP_REDIRECT_POLICY_MASK
0x0700
 您可以搭配安全性旗標值使用的位掩碼，以判斷哪些重新導向原則生效。 它不包含旗標ALLOW_HTTPS_TO_HTTP。

下列範例示範如何使用此遮罩來測試BG_HTTP_REDIRECT_POLICY_DISALLOW重新導向原則。

if (BG_HTTP_REDIRECT_POLICY_DISALLOW == (flags & BG_HTTP_REDIRECT_POLICY_MASK))
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。

規格需求

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

另請參閱

IBackgroundCopyJobHttpOptions

IBackgroundCopyJobHttpOptions：：SetSecurityFlags