IBackgroundCopyJob::GetErrorCount 方法 (bits.h)
检索 BITS 尝试传输作业并发生错误的次数。
语法
HRESULT GetErrorCount(
[out] ULONG *Errors
);
参数
[out] Errors
BITS 尝试传输作业时发生的错误数。 当作业从BG_JOB_STATE_TRANSFERRING状态移动到BG_JOB_STATE_TRANSIENT_ERROR或BG_JOB_STATE_ERROR状态时,计数会增加。
返回值
此方法在成功时返回 S_OK 或错误时返回标准 COM HRESULT 值之一。
注解
从不重置计数。 计数可能无法准确反映作业移动到暂时性错误或错误状态的次数。 例如,当网络断开连接、检查磁盘程序运行或带宽策略阻止作业传输时,BITS 不会增加计数。
当作业处于暂时性错误状态且作业失败时,BITS 还会增加每次尝试传输作业的计数。
BITS 1.5 及更早版本: 当作业处于暂时性错误状态时,BITS 不会在每次尝试传输作业时增加计数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP |
最低受支持的服务器 | Windows Server 2003 |
目标平台 | Windows |
标头 | bits.h |
Library | Bits.lib |
DLL | QmgrPrxy.dll |