IBitsPeerCacheAdministration::SetConfigurationFlags 方法 (bits3_0.h)

設定組態旗標,判斷計算機是否可以將內容提供給對等,而且可以從對等下載內容。

語法

HRESULT SetConfigurationFlags(
  [in] DWORD Flags
);

參數

[in] Flags

旗標,判斷計算機是否可以將內容提供給對等,並可從對等下載內容。 您可以設定下列旗標:

意義
BG_ENABLE_PEERCACHING_CLIENT
0x0001
計算機可以從對等下載內容。

除非用戶端計算機和作業允許 BITS 從對等下載檔,否則 BITS 將不會從對等下載檔。 若要允許作業從對等下載檔,請呼叫 IBackgroundCopyJob4::SetPeerCachingFlags 方法,並設定 BG_JOB_ENABLE_PEERCACHING_CLIENT 旗標。

請注意,變更此值可能會影響計算機上的所有作業。 如果存在下列其中一個條件,BITS 將會停止下載並重新排程作業,以根據作業和快取的值開始從對等或源伺服器傳輸:

  • 快取的這個值為 TRUE ,而作業的值會在 TRUEFALSE 之間切換。
  • 作業屬性的這個值為 TRUE ,而快取的值會在 TRUEFALSE 之間切換。
接著,下載會從其離開的位置繼續,再讓BITS停止作業。
BG_ENABLE_PEERCACHING_SERVER
0x0002
計算機可以提供內容給對等。

除非用戶端計算機和作業允許 BITS 快取和提供檔案,否則 BITS 不會快取檔案並將其提供給對等。 若要允許作業快取作業的檔案,請呼叫 IBackgroundCopyJob4::SetPeerCachingFlags 方法,並設定 BG_JOB_ENABLE_PEERCACHING_SERVER 旗標。

傳回值

方法會傳回下列傳回值。

傳回碼 描述
S_OK
Success
BG_S_OVERRIDDEN_BY_POLICY
設定喜好設定已成功儲存,但不會使用喜好設定,因為已設定 群組原則 設定會覆寫喜好設定。

如果設定的值與組策略值不同,此方法會傳回此值。 如果值相同,方法會傳回S_OK。

備註

只有在未設定 EnablePeerCaching 組策略時,才會使用此值。

作業會判斷它是否從對等下載內容,或將其內容提供給對等。 如需詳細資訊,請參閱 IBackgroundCopyJob4::SetPeerCachingFlags 方法。

規格需求

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

另請參閱

IBackgroundCopyJob4::SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration::GetConfigurationFlags