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 |
程式庫 | Mstask.lib |
Dll | Mstask.dll |
可轉散發套件 | Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本 |