iScheduledWorkItem：：GetExitCode 方法 (mstask.h)

  • 项目

[[此 API 可能在操作系统或产品的后续版本中更改或不可用。 请改用 任务计划程序 2.0 接口 。] ]

检索上次运行时与 工作项 关联的可执行文件返回的最后一个退出代码。 该方法还返回上次尝试运行工作项时返回到任务计划程序时的退出代码。

语法

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

参数

[out] pdwExitCode

指向设置为工作项的最后一个退出代码的 DWORD 值的指针。 这是工作项上次停止运行时返回的退出代码。 如果工作项从未启动，则返回 0。

返回值

GetExitCode 方法返回上次尝试启动工作项时的错误。 可能的值包括以下值。

返回代码 说明
S_OK
 尝试启动工作项已成功。
SCHED_S_TASK_HAS_NOT_RUN
 从未尝试过启动此工作项。
E_INVALIDARG
 参数无效。
E_OUTOFMEMORY
 内存不足。

注解

此方法可以返回以下两条信息：

  • 正在计划的可执行文件返回的错误或退出代码在 pdwExitCode 参数中返回。
  • 任务计划程序在尝试启动作业时收到的错误代码在 GetExitCode 方法调用本身中返回。
若要获取更新的错误代码，请始终先调用 ITaskScheduler：：Activate 以获取新的 IScheduledWorkItem 接口，然后可以使用该接口获取更新的错误代码。

示例

有关如何检索任务创建者的示例，请参阅 C/C++ 代码示例：检索任务退出代码。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mstask.h
Library Mstask.lib
DLL Mstask.dll
可再发行组件 Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更高版本

另请参阅

IScheduledWorkItem