iScheduledWorkItem：：CreateTrigger 方法 (mstask.h)

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

为工作项创建触发器。

语法

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

[out] piNewTrigger

指向新触发器返回的触发器索引值的指针。与工作项关联的第一个触发器的触发器索引为“0”。有关触发器索引的其他用法，请参阅“备注”。

[out] ppTrigger

指向 ITaskTrigger 接口的指针的指针。目前，唯一支持的工作项是任务。

CreateTrigger 方法返回以下值之一。

检索或删除触发器时，请使用 piNewTrigger 返回的触发器索引。但是，触发器索引不是标识符。它仅指示新触发器相对于与工作项关联的其他当前触发器的位置。

若要设置新触发器的条件，请调用 ITaskTrigger：：SetTrigger。

为工作项创建新触发器后，应用程序必须调用 IPersistFile：：Save 方法将新触发器保存到磁盘。

有关如何在创建新触发器时设置触发器条件的示例，请参阅创建新触发器。

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