IBackgroundCopyJob::GetState 方法 (bits.h)

检索作业的状态。

Syntax

HRESULT GetState(
  [out] BG_JOB_STATE *pVal
);

参数

[out] pVal

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

返回值

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

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

注解

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

例子

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

要求

Requirement 价值
最低支持的客户端 Windows XP
支持的最低服务器 Windows Server 2003
目标平台 Windows操作系统
Header bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

BG_JOB_STATE确定作业的状态IBackgroundCopyCallback