IBackgroundCopyJob 接口 (bits.h)

使用 IBackgroundCopyJob 接口将文件添加到作业、设置作业的优先级、确定作业的状态,以及启动和停止作业。

若要创建作业,请调用 IBackgroundCopyManager::CreateJob 方法。 若要获取指向现有作业 的 IBackgroundCopyJob 接口指针,请调用 IBackgroundCopyManager::GetJob 方法。

继承

IBackgroundCopyJob 接口继承自 IUnknown 接口。 IBackgroundCopyJob 还具有以下类型的成员:

方法

IBackgroundCopyJob 接口包含以下方法。

 
IBackgroundCopyJob::AddFile

将单个文件添加到作业。
IBackgroundCopyJob::AddFileSet

将多个文件添加到一个作业。
IBackgroundCopyJob::Cancel

从传输队列中删除作业,并从客户端中删除相关的临时文件, (下载) 和服务器 (上传) 。
IBackgroundCopyJob::Complete

结束作业并将传输的文件保存在客户端上。
IBackgroundCopyJob::EnumFiles

检索用于枚举作业中的文件的 IEnumBackgroundCopyFiles 接口指针。
IBackgroundCopyJob::GetDescription

检索作业的说明。
IBackgroundCopyJob::GetDisplayName

检索作业的显示名称。 通常,使用显示名称在用户界面中标识作业。
IBackgroundCopyJob::GetError

在发生错误后检索错误接口。
IBackgroundCopyJob::GetErrorCount

检索 BITS 尝试传输作业并发生错误的次数。
IBackgroundCopyJob::GetId

检索用于标识队列中作业的标识符。
IBackgroundCopyJob::GetMinimumRetryDelay

检索服务在尝试传输文件之前遇到暂时性错误条件后等待的最短时间长度。
IBackgroundCopyJob::GetNoProgressTimeout

检索发生暂时性错误条件后服务尝试传输文件的时间长度。 如果有进度,则重置计时器。
IBackgroundCopyJob::GetNotifyFlags

检索作业的事件通知标志。
IBackgroundCopyJob::GetNotifyInterface

检索指向 IBackgroundCopyCallback 接口实现的接口指针。
IBackgroundCopyJob::GetOwner

检索作业所有者的标识。
IBackgroundCopyJob::GetPriority

检索作业的优先级。 优先级确定相对于传输队列中其他作业处理作业的时间。
IBackgroundCopyJob::GetProgress

检索与作业相关的进度信息,例如传输的字节数和文件数。
IBackgroundCopyJob::GetProxySettings

检索作业用于传输文件的代理信息。
IBackgroundCopyJob::GetState

检索作业的状态。
IBackgroundCopyJob::GetTimes

检索与作业相关的时间戳,例如作业的创建时间或上次修改时间。
IBackgroundCopyJob::GetType

检索正在执行的传输类型,例如文件下载或上传。
IBackgroundCopyJob::Resume

激活新作业或重启已暂停的作业。
IBackgroundCopyJob::SetDescription

提供作业的说明。
IBackgroundCopyJob::SetDisplayName

指定作业的显示名称。 通常,使用显示名称在用户界面中标识作业。
IBackgroundCopyJob::SetMinimumRetryDelay

设置 BITS 在尝试传输文件之前遇到暂时性错误条件后等待的最短时间长度。
IBackgroundCopyJob::SetNoProgressTimeout

设置发生暂时性错误条件后 BITS 尝试传输文件的时间长度。 如果有进度,则重置计时器。
IBackgroundCopyJob::SetNotifyFlags

指定要接收的事件通知的类型,例如作业传输的事件。
IBackgroundCopyJob::SetNotifyInterface

标识对 BITS 的 IBackgroundCopyCallback 接口的实现。 使用 IBackgroundCopyCallback 接口接收作业相关事件的通知。
IBackgroundCopyJob::SetPriority

指定作业的优先级。 优先级确定相对于传输队列中的其他作业处理作业的时间。
IBackgroundCopyJob::SetProxySettings

指定用于传输文件的代理。
IBackgroundCopyJob::Suspend

挂起作业。 新作业、出错的作业和已完成文件传输的作业将自动挂起。
IBackgroundCopyJob::TakeOwnership

将作业的所有权更改为当前用户。

要求

要求
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 bits.h

另请参阅

IBackgroundCopyFile

IBackgroundCopyJob2

IBackgroundCopyJob3

IBackgroundCopyManager

IEnumBackgroundCopyJobs