ITriggerCollection::Create 方法(taskschd.h)

为任务创建新触发器。

语法

HRESULT Create(
  [in]  TASK_TRIGGER_TYPE2 type,
  [out] ITrigger           **ppTrigger
);

参数

[in] type

此参数设置为以下 TASK_TRIGGER_TYPE2 枚举常量之一。

价值 意义
TASK_TRIGGER_EVENT
0
在发生特定事件时触发任务。
TASK_TRIGGER_TIME
1
在特定的一天时间触发任务。
TASK_TRIGGER_DAILY
2
按每日计划触发任务。 例如,任务在每天的特定时间、每隔一天、第三天等开始。
TASK_TRIGGER_WEEKLY
3
按每周计划触发任务。 例如,任务从每周或其他星期的特定日期上午 8:00 开始。
TASK_TRIGGER_MONTHLY
4
按月计划触发任务。 例如,任务在特定月份的特定日期开始。
TASK_TRIGGER_MONTHLYDOW
5
按每月一周计划触发任务。 例如,该任务在一周的特定日期、月份的周数和一年中的月份开始。
TASK_TRIGGER_IDLE
6
在计算机进入空闲状态时触发任务。
TASK_TRIGGER_REGISTRATION
7
在注册任务时触发任务。
TASK_TRIGGER_BOOT
8
在计算机启动时触发任务。
TASK_TRIGGER_LOGON
9
在特定用户登录时触发任务。
TASK_TRIGGER_SESSION_STATE_CHANGE
11
当特定会话状态发生更改时触发任务。

[out] ppTrigger

表示新触发器的 ITrigger 接口。

传入对 NULLITrigger 接口指针的引用。 引用非NULL 指针可能会导致内存泄漏,因为该指针将被覆盖。

返回值

如果此方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

要求

要求 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
目标平台 窗户
标头 taskschd.h
Taskschd.lib
DLL Taskschd.dll

另请参阅

ITriggerCollection

任务计划程序