IBackgroundCopyError 接口 (bits.h)

使用
IBackgroundCopyError 接口,用于确定错误原因以及传输过程是否可以继续。

仅当作业的状态为BG_JOB_STATE_ERROR或BG_JOB_STATE_TRANSIENT_ERROR时,BITS 才会创建错误对象。 当 IBackgroundCopyXXXX 接口方法失败时,BITS 不会创建错误对象。 在 BITS 开始传输数据 (作业的状态更改为作业BG_JOB_STATE_TRANSFERRING) 或应用程序退出之前,错误对象才可用。

若要获取 IBackgroundCopyError 对象,请调用 IBackgroundCopyJob::GetError 方法。

继承

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

方法

IBackgroundCopyError 接口具有这些方法。

 
IBackgroundCopyError::GetError

检索错误代码并标识发生错误的上下文。
IBackgroundCopyError::GetErrorContextDescription

检索发生错误的上下文的说明。
IBackgroundCopyError::GetErrorDescription

检索与错误关联的错误文本。
IBackgroundCopyError::GetFile

检索指向与错误关联的文件对象的接口指针。
IBackgroundCopyError::GetProtocol

检索用于传输文件的协议。 远程文件名标识用于传输文件的协议。

要求

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

另请参阅

BG_JOB_STATE

IBackgroundCopyCallback::JobError

IBackgroundCopyJob::GetError

IBackgroundCopyJob::GetState

IBackgroundCopyManager::GetErrorDescription