BITS_JOB_PROPERTY_ID列舉 (bits5_0.h)

  • 發行項

定義常數，指定 BITS 作業之 屬性的識別碼。

此列舉用於 BITS_JOB_PROPERTY_VALUE 聯集，以判斷聯集中包含的值類型。

Syntax

typedef enum BITS_JOB_PROPERTY_ID {
  BITS_JOB_PROPERTY_ID_COST_FLAGS = 1,
  BITS_JOB_PROPERTY_NOTIFICATION_CLSID = 2,
  BITS_JOB_PROPERTY_DYNAMIC_CONTENT = 3,
  BITS_JOB_PROPERTY_HIGH_PERFORMANCE = 4,
  BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE = 5,
  BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS = 7,
  BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS = 9,
  BITS_JOB_PROPERTY_ON_DEMAND_MODE = 10
} ;

常數

 
BITS_JOB_PROPERTY_ID_COST_FLAGS
值： 1
用來控制透過行動數據及/或類似網路的 傳輸行為的 標識符。 在傳輸進行時，可能會變更此屬性 –新的成本旗標將會立即生效。

此屬性使用 BITS_JOB_PROPERTY_VALUE 的 DWORD 欄位。
BITS_JOB_PROPERTY_NOTIFICATION_CLSID
值： 2
用來由 CLSID 註冊 COM 回呼 的識別碼，以接收 BITS 作業進度和完成的相關通知。 CLSID 必須參考與已註冊的跨進程 COM 伺服器相關聯的類別。 它也可以設定為 GUID_NULL ，以清除先前設定的通知 CLSID。

此屬性使用 BITS_JOB_PROPERTY_VALUE 的 CLsID 欄位。
BITS_JOB_PROPERTY_DYNAMIC_CONTENT
值： 3
將 BITS 作業標示為願意下載不支援 BITS 下載一般 HTTP 需求的標識碼：HEAD 要求、Content-Length 標頭和 Content-Range 標頭。 下載這種類型的內容是選擇加入，因為 BITS 無法在不支援的情況下暫停和繼續下載工作。 如果啟用此屬性的作業因任何原因而中斷，例如暫時遺失網路連線或系統重新啟動，BITS 會從頭重新啟動下載，而不是繼續離開的位置。 BITS 也無法節流動態下載的頻寬使用量;BITS 不會針對未 指派BG_JOB_PRIORITY_FOREGROUND的任何 作業執行未中斷傳輸，因此您通常應該在每次使用設定作業時設定該優先順序，以允許動態內容。

此屬性使用 BITS_JOB_PROPERTY_VALUE的 [ 啟用 ] 字段。 此屬性僅支援 BG_JOB_TYPE_DOWNLOAD 作業。 不支援使用 FILE_RANGES 的下載。 只有在第一次在作業上呼叫 Resume 之前，才能設定這個屬性。
BITS_JOB_PROPERTY_HIGH_PERFORMANCE
值： 4
將 BITS 作業標示為不需要強式可靠性保證的標識碼。 啟用此屬性會導致 BITS 避免保存正常作業進度的相關信息，BITS 通常會定期執行。 如果發生非預期的關機，例如電源中斷，在傳輸期間，這會導致 BITS 失去進度

然後從頭開始重新啟動作業，而不是像往常一樣從其離開的位置繼續作業。 不過，它也會減少在作業存留期期間所建立的磁碟寫入 BITS 數目，進而改善較小作業的效能。

此屬性也會讓 BITS 直接下載到目的地檔案，而不是下載至臨時檔，並在傳輸完成後將臨時檔移至最終目的地。 這表示如果作業已取消或遇到嚴重錯誤狀況，BITS 將不會清除任何部分下載的內容;如果建立目的地檔案，BITS 呼叫端會負責清除目的地檔案。 不過，它也會稍微降低磁碟額外負荷。

只有在涉及大量小型作業的案例中，才建議使用此屬性， (低於 1MB) ，而且不需要可靠性來電源遺失或其他非預期的關機事件。 對少量作業或較大型作業而言，效能節省通常並不重要。

此屬性使用 BITS_JOB_PROPERTY_VALUE的 [ 啟用 ] 字段。 此屬性僅支援 BG_JOB_TYPE_DOWNLOAD 作業。 只有在將任何檔案新增至作業之前，才能設定這個屬性。
BITS_JOB_PROPERTY_MAX_DOWNLOAD_SIZE
值： 5
用來標記 BITS 作業最大位元組數目的識別碼，將允許下載總計。 此屬性適用於 BITS_JOB_PROPERTY_DYNAMIC_CONTENT，您無法事先判斷要下載的檔案大小，但想要限制可能的下載大小總計。

此屬性使用 BITS_JOB_PROPERTY_VALUE的 [ 啟用 ] 字段。 此屬性僅支援 BG_JOB_TYPE_DOWNLOAD 作業。 只有在第一次在作業上呼叫 Resume 之前，才能設定這個屬性。
BITS_JOB_PROPERTY_USE_STORED_CREDENTIALS
值： 7
將 BITS 作業標示為願意在 Proxy 伺服器要求中包含預設認證的識別碼。 啟用此屬性相當於在 BITS 代表使用者提出的要求上，設定WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM的 WinHTTP 安全性層級。 使用者 BITS 會從 擷取儲存的認證，與它代表網路要求一樣：BITS 通常會使用作業擁有者的認證，除非您已明確提供網路 協助程式令牌，在此情況下，BITS 會使用網路協助程式令牌的認證。

此屬性使用 BITS_JOB_PROPERTY_VALUE 的 [目標] 欄位。 不過，僅支援 BG_AUTH_TARGET_PROXY 目標。
BITS_JOB_PROPERTY_MINIMUM_NOTIFICATION_INTERVAL_MS
值： 9
用來控制 BITS JobNotification 和 FileRangesTransferred 通知計時的標識符。 啟用此屬性可讓使用者以不同的速率收到通知。 在傳輸進行時，可能會變更此屬性;不過，可能不會立即套用新的費率。 預設值為 500 毫秒。

此屬性使用 BITS_JOB_PROPERTY_VALUE 的 DWORD 欄位。
BITS_JOB_PROPERTY_ON_DEMAND_MODE
值： 10
用來控制作業是否為隨選模式的標識碼。 隨選作業可讓應用程式要求檔案下載的特定範圍，而不是從頭到尾下載。 默認值為 FALSE;作業不是隨選作業。 使用 IBackgroundCopyFile6：：RequestFileRanges 方法來要求範圍。

此屬性使用 BITS_JOB_PROPERTY_VALUE的 [ 啟用 ] 字段。

BITS_JOB_PROPERTY_ON_DEMAND_MODE作業的需求是傳輸必須是BG_JOB_TYPE_DOWNLOAD作業。 此作業不得為 DYNAMIC ，而且伺服器必須是 HTTP 或 HTTPS 伺服器，而且必須符合範圍支援的伺服器需求。

規格需求

需求 值
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
標頭 bits5_0.h

另請參閱