ITask：：SetMaxRunTime 方法 (mstask.h)
[[此 API 可能在操作系统或产品的后续版本中被更改或不可用。 请改用 任务计划程序 2.0 接口 。] ]
此方法设置 任务 在终止前可以运行的最长时间（以毫秒为单位）。
语法
HRESULT SetMaxRunTime(
[in] DWORD dwMaxRunTimeMS
);
参数
[in] dwMaxRunTimeMS
一个 DWORD 值，该值指定任务的最大运行时间 (毫秒) 。 此参数可以设置为 INFINITE 以指定无限时间。
返回值
SetMaxRunTime 方法返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
操作成功。 |
|
参数无效。 |
|
内存不足。 |
注解
超过最大运行时间时，任务计划程序会尝试终止与任务关联的应用程序。 例如，如果 (无法发送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 或更高版本 |