設定 HTTP 旗標,判斷是否檢查憑證撤銷清單及忽略某些憑證錯誤,以及伺服器重定向 HTTP 請求時的政策。
語法
HRESULT SetSecurityFlags(
[in] ULONG Flags
);
參數
[in] Flags
HTTP 安全標誌,指示連接伺服器時應忽略的錯誤。 你可以設定以下一個或多個旗標:
返回值
下表列出了一些可能的回傳值。
| 回傳碼 | Description |
|---|---|
|
成功取得標頭。 |
|
旗標值不被支援。 |
備註
若要求 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)
如果啟用了點對等快取並指定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 |