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 ，作业的值在 TRUE 和 FALSE 之间切换。
  • 作业属性的此值为 TRUE ，缓存的值在 TRUE 和 FALSE 之间切换。
然后，下载将从 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
 成功

注解

仅当通过设置 EnablePeerCaching 组策略或调用 IBitsPeerCacheAdministration：：SetConfigurationFlags 来启用对等缓存时，设置这些标志才有意义。

要求

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

另请参阅

IBackgroundCopyJob4

IBackgroundCopyJob4：：GetPeerCachingFlags

IBitsPeerCacheAdministration：：SetConfigurationFlags