使用 NewWorkItem 创建任务示例

创建任务时,将使用两个任务计划程序接口: ITaskSchedulerITask。 必须提供任务的唯一名称、任务对象的类标识符和 ITask 的接口标识符。 本主题后面的代码示例中显示了类标识符和接口标识符。

注意

还可以通过调用 ITaskScheduler::AddWorkItem 来创建任务。 采用此路由时,你有责任创建支持 ITask 接口的 Task 对象的实例 () ,然后添加具有你提供的名称的任务。

 

注意

默认情况下,只有管理员、备份操作员或服务器操作员组的成员才能在 Windows Server 2003 上创建任务。 管理员组的成员可以更改 Windows\Task 文件夹的安全描述符,以允许其他人创建任务。

 

为任务提供的名称在“计划任务”文件夹中必须是唯一的。 如果已存在同名的任务, 则 ITaskScheduler::NewWorkItem 将返回ERROR_FILE_EXISTS。 如果获取此返回值,则应指定其他名称并尝试再次创建任务。

以下过程介绍如何创建新的工作项任务。

创建新的工作项任务

  1. 调用 CoInitialize 初始化 COM 库,并调用 CoCreateInstance 以获取 Task 计划程序对象。 (此示例假定任务计划程序服务正在运行。)
  2. 调用 ITaskScheduler::NewWorkItem 创建新任务。 (此方法返回指向 ITask 接口的指针。)
  3. 通过调用 IPersistFile::Save 将新任务保存到磁盘。 (IPersistFile 接口是 ITask 接口支持的标准 COM 接口。)
  4. 调用 ITask::Release 以释放所有资源。 (请注意,ReleaseITask.) 继承的 IUnknown 方法
有关 的代码示例 请参阅
创建单个任务 C/C++ 代码示例:使用 NewWorkItem 创建任务

 

任务计划程序 1.0 示例