IBackgroundCopyJob::GetState 方法 (bits.h)

检索作业的状态。

语法

HRESULT GetState(
  [out] BG_JOB_STATE *pVal
);

参数

[out] pVal

作业的状态。 例如,状态反映作业是出错、传输数据还是挂起。 有关作业状态的列表,请参阅 BG_JOB_STATE 枚举。

返回值

此方法返回以下 HRESULT 值以及其他值。

返回代码 说明
S_OK
已成功检索作业的状态。
E_INVALIDARG
参数 pJobState 不能为 NULL

注解

如果想知道作业何时出错或传输了作业中的所有文件,可以使用此方法轮询作业的状态,也可以注册以在事件发生时接收通知。 有关注册以接收事件通知的详细信息,请参阅 IBackgroundCopyCallback 接口。

示例

请参阅 IBackgroundCopyManager::GetJob 方法的示例代码。

要求

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

另请参阅

BG_JOB_STATE确定作业的状态IBackgroundCopyCallback