IScheduledWorkItem::CreateTrigger 方法 (mstask.h)

[[此 API 可能會在後續版本的操作系統或產品中變更或無法使用。 請改用 工作排程器 2.0 介面 。] ]

建立 工作項目的觸發程式。

語法

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

參數

[out] piNewTrigger

新觸發程式傳回之觸發程式索引值的指標。 與工作專案相關聯的第一個觸發程式的觸發程式索引是 “0”。 如需觸發程式索引的其他用途,請參閱。

[out] ppTrigger

ITaskTrigger 介面指標的指標。 目前唯一支援的工作專案是 工作

傳回值

CreateTrigger 方法會傳回下列其中一個值。

傳回碼 描述
S_OK
作業成功。
E_INVALIDARG
自變數無效。
E_OUTOFMEMORY
記憶體不足。

備註

當您擷取或刪除觸發程式時,您會使用 piNewTrigger 所傳回的觸發程式索引。 不過,觸發程式索引不是標識符。 它只會指出新觸發程式相對於與工作項目相關聯之其他目前觸發程式的位置。

若要設定新觸發程式的準則,請呼叫 ITaskTrigger::SetTrigger

建立工作專案的新觸發程式之後,應用程式必須呼叫 IPersistFile::Save 方法,才能將新的觸發程式儲存至磁碟。

範例

如需如何在建立新觸發程式時設定觸發準則的範例,請參閱 建立新的觸發程式

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mstask.h
程式庫 Mstask.lib
Dll Mstask.dll
可轉散發套件 Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本

另請參閱

IPersistFile::Save

IScheduledWorkItem

IScheduledWorkItem::D eleteTrigger

IScheduledWorkItem::GetTrigger

IScheduledWorkItem::GetTriggerString

ITaskTrigger

ITaskTrigger::SetTrigger