共用方式為

DODownloadProperty 列舉 (deliveryoptimization.h)

DODownloadProperty列舉會指定傳遞優化下載作業的屬性識別碼。 IDODownload介面會使用此列舉，並由 VARIANT 值執行，其中包含值的型別。

Syntax

typedef enum _DODownloadProperty {
  DODownloadProperty_Id,
  DODownloadProperty_Uri,
  DODownloadProperty_ContentId,
  DODownloadProperty_DisplayName,
  DODownloadProperty_LocalPath,
  DODownloadProperty_HttpCustomHeaders,
  DODownloadProperty_CostPolicy,
  DODownloadProperty_SecurityFlags,
  DODownloadProperty_CallbackFreqPercent,
  DODownloadProperty_CallbackFreqSeconds,
  DODownloadProperty_NoProgressTimeoutSeconds,
  DODownloadProperty_ForegroundPriority,
  DODownloadProperty_BlockingMode,
  DODownloadProperty_CallbackInterface,
  DODownloadProperty_StreamInterface,
  DODownloadProperty_SecurityContext,
  DODownloadProperty_NetworkToken,
  DODownloadProperty_CorrelationVector,
  DODownloadProperty_DecryptionInfo,
  DODownloadProperty_IntegrityCheckInfo,
  DODownloadProperty_IntegrityCheckMandatory,
  DODownloadProperty_TotalSizeBytes,
  DODownloadProperty_DisallowOnCellular,
  DODownloadProperty_HttpCustomAuthHeaders,
  DODownloadProperty_HttpAllowSecureToNonSecureRedirect,
  DODownloadProperty_NonVolatile,
  DODownloadProperty_HttpRedirectionTarget,
  DODownloadProperty_HttpResponseHeaders,
  DODownloadProperty_HttpServerIPAddress,
  DODownloadProperty_HttpStatusCode
} DODownloadProperty;

常數

 
DODownloadProperty_Id
唯讀。 使用這個屬性取得可唯一識別下載的識別碼。 VARIANT 類型VT_BSTR。
DODownloadProperty_Uri
使用這個屬性來設定或取得要下載之資源的遠端 URI 路徑。 只有在未提供 DODownloadProperty_ContentId 時，才需要此屬性。 VARIANT 類型VT_BSTR。
DODownloadProperty_ContentId
使用這個屬性來設定或取得下載的唯一內容識別碼。 只有在未提供 DODownloadProperty_Uri 時，才需要此屬性。 VARIANT 類型VT_BSTR。
DODownloadProperty_DisplayName
選擇性。 使用這個屬性來設定或取得下載顯示名稱。 VARIANT 類型VT_BSTR。
DODownloadProperty_LocalPath
使用這個屬性來設定或取得本機路徑名稱，以儲存下載檔案。 如果路徑不存在，傳遞優化會嘗試在呼叫者的許可權下建立它。 只有在未提供 DODownloadProperty_StreamInterface 時，才需要此屬性。 VARIANT 類型VT_BSTR。
DODownloadProperty_HttpCustomHeaders
選擇性。 使用這個屬性來設定或取得自訂 HTTP 要求標頭。 傳遞優化會在 HTTP 檔案要求作業期間包含這些標頭。 標頭必須已經格式化為標準 HTTP 標頭。 VARIANT 類型VT_BSTR。
DODownloadProperty_CostPolicy
選擇性。 使用這個屬性來設定或取得其中一個 DODownloadCostPolicy 列舉值。 VARIANT 類型VT_UI4。
DODownloadProperty_SecurityFlags
選擇性的僅限寫入。 使用這個屬性來設定或取得標準 WinHTTP 安全性旗標， (WINHTTP_OPTION_SECURITY_FLAGS) 。 VARIANT 類型VT_UI4。

支援下列旗標：

* SECURITY_FLAG_IGNORE_CERT_CN_INVALID。 允許憑證中的一般名稱無效。
* SECURITY_FLAG_IGNORE_CERT_DATE_INVALID。 允許不正確憑證日期。
* SECURITY_FLAG_IGNORE_UNKNOWN_CA。 允許不正確憑證授權單位單位。
* SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE。 允許使用非伺服器憑證建立伺服器的身分識別。
* WINHTTP_ENABLE_SSL_REVOCATION。 允許 SSL 撤銷。 如果設定此旗標，則會忽略上述旗標。
DODownloadProperty_CallbackFreqPercent
選擇性。 使用這個屬性，根據下載百分比來設定或取得回呼頻率。 VARIANT 類型VT_UI4。
DODownloadProperty_CallbackFreqSeconds
選擇性。 使用這個屬性，根據下載時間來設定或取得回呼頻率。 預設值為每一秒。 VARIANT 類型VT_UI4。
DODownloadProperty_NoProgressTimeoutSeconds
選擇性。 使用這個屬性來設定或取得下載逾時長度，以進行無進度。 接受的最小值為 60 秒，沒有下載活動。 VARIANT 類型VT_UI4。
DODownloadProperty_ForegroundPriority
選擇性。 使用這個屬性來設定或取得目前的下載優先順序。 VARIANT_TRUE值會將下載帶到優先順序較高的前景。 預設值為背景優先順序。 VARIANT 類型VT_BOOL。
DODownloadProperty_BlockingMode
選擇性。 使用這個屬性來設定或取得目前的下載封鎖模式。 VARIANT_TRUE值會導致 IDODownload：：Start 封鎖，直到下載完成或發生錯誤為止。 預設值為非封鎖模式。 VARIANT 類型VT_BOOL。
DODownloadProperty_CallbackInterface
選擇性。 使用這個屬性來設定或取得用於下載回呼 的 IDODownloadStatusCallback 介面指標。 VARIANT 類型VT_UNKNOWN。
DODownloadProperty_StreamInterface
選擇性。 使用這個屬性來設定或取得用於資料流程下載類型的 IStream 介面指標。 VARIANT 類型VT_UNKNOWN。
DODownloadProperty_SecurityContext
選擇性的僅限寫入。 使用這個屬性可設定在 HTTP 要求作業期間使用的憑證內容。 此值必須包含序列化的位元組CERT_CONTEXT。 VARIANT 類型 (VT_ARRAY |VT_UI1) 。
DODownloadProperty_NetworkToken
選擇性的僅限寫入。 使用這個屬性可設定 HTTP 作業期間要使用的網路權杖。 VARIANT_TRUE值會導致傳遞優化擷取呼叫端的身分識別權杖，而VARIANT_FALSE會清除現有的權杖。 預設值是登入使用者的權杖。 VARIANT 類型VT_BOOL。
DODownloadProperty_CorrelationVector
選擇性。 設定遙測用途的特定相互關聯向量。 VARIANT 類型VT_BSTR。
DODownloadProperty_DecryptionInfo
選擇性的僅限寫入。 以 JSON 字串的形式設定解密資訊。 VARIANT 類型VT_BSTR。
DODownloadProperty_IntegrityCheckInfo
選擇性的僅限寫入。 (PHF) 位置設定片段雜湊檔案，此位置由傳遞優化用來對下載的內容執行執行時間完整性檢查。 VARIANT 類型VT_BSTR。
DODownloadProperty_IntegrityCheckMandatory
選擇性。 設定布林值旗標，指出是否強制使用片段雜湊檔案 (PHF) 。 如果VARIANT_TRUE，如果完整性檢查失敗，將會中止下載。 VARIANT 類型VT_BOOL。
DODownloadProperty_TotalSizeBytes
選擇性。 指定位元組的下載大小總計。 VARIANT 類型VT_UI8。
DODownloadProperty_DisallowOnCellular
在行動資料連線時，請勿下載。
DODownloadProperty_HttpCustomAuthHeaders
當挑戰時，會使用自訂 HTTPS 標頭。
DODownloadProperty_HttpAllowSecureToNonSecureRedirect
Https-to-HTTP 重新導向。 預設為 FALSE。
DODownloadProperty_NonVolatile
將下載資訊儲存至 Windows 登錄。 預設為 FALSE 傳遞優化下載作業; TRUE 針對 BITS 樣式的作業。

需求

   
最低支援的用戶端 Windows 11組建 22621
標頭 deliveryoptimization.h
  • Last updated on