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 ，作业的值在 TRUE 和 FALSE 之间切换。
  • 作业属性的此值为 TRUE ，缓存的值在 TRUE 和 FALSE 之间切换。
然后，下载将从 BITS 停止作业之前停止的位置恢复。
BG_ENABLE_PEERCACHING_SERVER
0x0002
 计算机可以为对等方提供内容。

除非客户端计算机和作业都允许 BITS 缓存和提供文件，否则 BITS 不会缓存文件并将其提供给对等方。 若要允许作业缓存作业的文件，请调用 IBackgroundCopyJob4：：SetPeerCachingFlags 方法并设置BG_JOB_ENABLE_PEERCACHING_SERVER标志。

返回值

方法返回以下返回值。

返回代码 说明
S_OK
 成功
BG_S_OVERRIDDEN_BY_POLICY
 已成功保存配置首选项，但不会使用该首选项，因为配置的组策略设置将替代首选项。

如果设置的值与组策略值不同，方法将返回此值。 如果值相同，该方法将返回S_OK。

注解

仅当未设置 EnablePeerCaching 组策略时，才使用此值。

作业确定它是从对等方下载内容还是将其内容传递给对等方。 有关详细信息，请参阅 IBackgroundCopyJob4：：SetPeerCachingFlags 方法。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 bits3_0.h (包括 Bits.h)
Library Bits.lib

另请参阅

IBackgroundCopyJob4：：SetPeerCachingFlags

IBitsPeerCacheAdministration

IBitsPeerCacheAdministration：：GetConfigurationFlags