通过

iTaskTrigger：：SetTrigger 方法 (mstask.h)

  • 项目

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

SetTrigger 方法设置任务触发器的触发器条件。

语法

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

参数

[in] pTrigger

指向 TASK_TRIGGER 结构的指针，该结构包含定义新任务触发器的值。

返回值

SetTrigger 方法返回以下值之一。

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

注解

TASK_TRIGGER 结构的 wBeginDay、wBeginMonth 和 wBeginYear 成员必须分别设置为有效的日、月和年。

一个任务可以有任意数量的触发器与之关联。 任务运行的时间为该任务定义的所有触发器的并集。

若要使用这些新的触发器设置更新任务，应用程序必须在调用 SetTrigger 后调用 IPersistFile：：Save 方法。

示例

以下代码显示了此方法的变量声明和调用语法，包括 TASK_TRIGGER的必需成员。 创建新触发器时设置触发器条件，请参阅 创建新触发器。

HRESULT hr = S_OK;

TASK_TRIGGER Trigger;

ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));

Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;

// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
   printf("Failed SetTrigger\n");
   exit(1);
}

要求

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

另请参阅

IPersistFile：：Save

ITaskTrigger

ITaskTrigger：：GetTrigger

TASK_TRIGGER