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 [仅限桌面应用]
目标平台 Windows
标头 taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

另请参阅

ITriggerCollection

任务计划程序