iScheduledWorkItem::D eleteTrigger 方法 (mstask.h)
[[此 API 可能在操作系统或产品的后续版本中更改或不可用。 请改用 任务计划程序 2.0 接口 。] ]
从 工作项中删除触发器。
语法
HRESULT DeleteTrigger(
[in] WORD iTrigger
);
参数
[in] iTrigger
指定要删除的触发器的触发器索引值。 有关详细信息,请参阅“备注”。
返回值
DeleteTrigger 方法返回以下值之一。
返回代码 | 说明 |
---|---|
|
操作成功。 |
|
参数无效。 |
|
内存不足。 |
注解
创建触发器时,会为每个触发器创建一个触发器索引。 但是,它不是特定触发器的唯一标识符。 例如,如果创建四个触发器,则它们的编号为 0 到 3。 但是,如果删除第二个触发器,其余触发器的编号将为 0 到 2。 请注意,第一个触发器的索引始终为 0,最后一个触发器的索引比工作项的触发器总数少一 (TriggerCount -1) 。
可以使用 IScheduledWorkItem::GetTriggerCount 检索触发器计数。
若要完成触发器的删除,程序必须在调用 DeleteTrigger 后调用 IPersistFile::Save 方法。 调用 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 或更高版本 |