共用方式為


IBackgroundCopyJob4::SetPeerCachingFlags 方法 (bits3_0.h)

設定旗標,判斷作業的檔案是否可以快取並提供給對等,以及作業是否可以從對等下載內容。

語法

HRESULT SetPeerCachingFlags(
  [in] DWORD Flags
);

參數

[in] Flags

旗標,判斷作業的檔案是否可以快取並提供給對等,以及作業是否可以從對等下載內容。 您可以設定下列旗標:

意義
BG_JOB_ENABLE_PEERCACHING_CLIENT
0x0001
作業可以從對等下載內容。

除非用戶端計算機和作業都允許背景智慧型手機傳輸服務 (BITS) 從對等下載檔,否則作業將不會從對等下載。 若要讓用戶端計算機從對等下載檔,請設定 EnablePeerCaching 組策略或呼叫 IBitsPeerCacheAdministration::SetConfigurationFlags 方法,並設定BG_ENABLE_PEERCACHING_CLIENT旗標。

如果存在下列其中一個條件,BITS 將會停止下載並重新排程作業,以根據作業和快取的值開始從對等或源伺服器傳輸:

  • 快取的此值為 TRUE ,而作業的值會在 TRUEFALSE 之間切換。
  • 作業屬性的這個值為 TRUE ,而且快取的值會在 TRUEFALSE 之間切換。
接著,下載會從它離開的位置繼續,然後 BITS 停止作業。BITS 4.0: 此旗標已被取代。
BG_JOB_ENABLE_PEERCACHING_SERVER
0x0002
作業的檔案可以快取並提供給對等。

除非用戶端計算機和作業允許 BITS 快取及處理檔案,否則 BITS 不會快取檔案並將其提供給對等。 若要允許 BITS 快取並處理用戶端電腦上的檔案,請設定 EnablePeerCaching 組策略或呼叫 IBitsPeerCacheAdministration::SetConfigurationFlags 方法,並設定BG_ENABLE_PEERCACHING_SERVER旗標。BITS 4.0: 此旗標已被取代。

BG_JOB_DISABLE_BRANCH_CACHE
0x0004
BITS 不會使用 Windows BranchCache 進行傳輸作業。 此設定不會影響 BITS 以外的應用程式使用 Windows BranchCache。

傳回值

方法會傳回下列值。

傳回碼 描述
S_OK
Success

備註

只有在設定 EnablePeerCaching 組策略或呼叫 IBitsPeerCacheAdministration::SetConfigurationFlags 來啟用對等快取時,設定這些旗標才有意義。

規格需求

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

另請參閱

IBackgroundCopyJob4

IBackgroundCopyJob4::GetPeerCachingFlags

IBitsPeerCacheAdministration::SetConfigurationFlags