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

另請參閱

CreateTrigger

IScheduledWorkItem

IScheduledWorkItem：：GetTriggerCount