检索作业的状态。
Syntax
HRESULT GetState(
[out] BG_JOB_STATE *pVal
);
参数
[out] pVal
作业的状态。 例如,状态反映作业是出错、传输数据还是挂起。 有关作业状态的列表,请参阅 BG_JOB_STATE 枚举。
返回值
此方法返回以下 HRESULT 值以及其他值。
| 返回代码 | Description |
|---|---|
|
已成功检索作业的状态。 |
|
参数 pJobState 不能为 NULL。 |
注解
如果想要知道作业出错或已传输作业中的所有文件,则可以使用此方法轮询作业的状态,也可以注册以在事件发生时接收通知。 有关注册以接收事件通知的详细信息,请参阅 IBackgroundCopyCallback 接口。
例子
请参阅 IBackgroundCopyManager::GetJob 方法的示例代码。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP |
| 支持的最低服务器 | Windows Server 2003 |
| 目标平台 | Windows操作系统 |
| Header | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |