iTaskTrigger：：SetTrigger 方法 (mstask.h)

项目
02/29/2024

[[此 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 或更高版本