ITask::SetMaxRunTime 方法 (mstask.h)

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

此方法设置 任务 在终止前可以运行的最长时间(以毫秒为单位)。

语法

HRESULT SetMaxRunTime(
  [in] DWORD dwMaxRunTimeMS
);

参数

[in] dwMaxRunTimeMS

一个 DWORD 值,该值指定任务的最大运行时间 (毫秒) 。 此参数可以设置为 INFINITE 以指定无限时间。

返回值

SetMaxRunTime 方法返回以下值之一。

返回代码 说明
S_OK
操作成功。
E_INVALIDARG
参数无效。
E_OUTOFMEMORY
内存不足。

注解

超过最大运行时间时,任务计划程序会尝试终止与任务关联的应用程序。 例如,如果 (无法发送WM_CLOSE消息,应用程序没有窗口) 或者应用程序在接收WM_CLOSE后的三分钟内未退出,则任务计划程序将使用 TerminateProcess 终止应用程序。

设置最长运行时间后,请务必调用 IPersistFile::Save ,将修改后的任务对象保存到磁盘。

示例

有关如何设置最大运行时间的示例,请参阅 C/C++ 代码示例:设置 MaxRunTime

要求

要求
最低受支持的客户端 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 或更高版本

另请参阅

IGetMaxRunTime

ITask