iScheduledWorkItem::D eleteTrigger 方法 (mstask.h)

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

工作项中删除触发器。

语法

HRESULT DeleteTrigger(
  [in] WORD iTrigger
);

参数

[in] iTrigger

指定要删除的触发器的触发器索引值。 有关详细信息,请参阅“备注”。

返回值

DeleteTrigger 方法返回以下值之一。

返回代码 说明
S_OK
操作成功。
E_INVALIDARG
参数无效。
E_OUTOFMEMORY
内存不足。

注解

创建触发器时,会为每个触发器创建一个触发器索引。 但是,它不是特定触发器的唯一标识符。 例如,如果创建四个触发器,则它们的编号为 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 或更高版本

另请参阅

CreateTrigger

IScheduledWorkItem

IScheduledWorkItem::GetTriggerCount