IBackgroundCopyJob 接口
使用 IBackgroundCopyJob 接口将文件添加到作业、设置作业的优先级、确定作业的状态,以及启动和停止作业。
若要创建作业,请调用 IBackgroundCopyManager::CreateJob 方法。 若要获取指向现有作业 的 IBackgroundCopyJob 接口指针,请调用 IBackgroundCopyManager::GetJob 方法。
成员
IBackgroundCopyJob 接口继承自 IUnknown 接口。 IBackgroundCopyJob 还具有以下类型的成员:
方法
IBackgroundCopyJob 接口包含以下方法。
方法 | 说明 |
---|---|
取消 | 取消作业并从客户端中删除临时文件。 |
完成 | 结束作业并将传输的文件保存在客户端上。 |
EnumFiles | 返回指向枚举器对象的接口指针,该对象用于枚举作业中的文件。 |
GetDisplayName | 检索标识作业的显示名称。 |
GetError | 在发生错误后检索指向错误对象的接口指针。 |
GetId | 检索队列中作业的标识符。 |
GetNoProgressTimeout | 检索传递优化在遇到暂时性错误条件后继续尝试传输文件的时间长度。 |
GetNotifyFlags | 检索为应用程序设置的事件通知 (回调) 标志。 |
GetNotifyInterface | 检索指向 IBackgroundCopyCallback 接口实现的指针, (回调) 。 |
GetPriority | 检索为作业设置的优先级。 |
GetProgress | 检索与作业相关的进度信息,例如传输到客户端的字节数和文件数。 |
GetState | 检索作业的状态。 |
GetTimes | 检索与作业相关的活动的时间戳,例如创建作业的时间。 |
GetType | 检索正在执行的传输类型,例如文件下载。 |
继续 | 启动新作业或重启挂起的作业。 |
SetNoProgressTimeout | 指定传递优化在遇到暂时性错误条件后继续尝试传输文件的时间长度。 |
SetNotifyFlags | 指定要接收的事件通知的类型。 |
SetNotifyInterface | 指定指向 IBackgroundCopyCallback 接口实现 (回调) 的指针。 接口根据设置的事件通知标志接收通知。 |
SetPriority | 指定作业相对于传输队列中其他作业的优先级。 |
暂停 | 暂停作业。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 10版本 1709 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 版本 1709 [仅限桌面应用] |
标头 |
|
IDL |
|
库 |
|
DLL |
|
IID |
IID_IBackgroundCopyJob定义为 37668D37-507E-4160-9316-26306D150B12 |