ITaskTrigger：：SetTrigger 方法 (mstask.h)

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

SetTrigger 方法會設定工作觸發程式的觸發條件。

語法

HRESULT SetTrigger(
  [in] const PTASK_TRIGGER pTrigger
);

參數

[in] pTrigger

TASK_TRIGGER 結構的指標，其中包含定義新工作觸發程式的值。

傳回值

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

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

備註

TASK_TRIGGER 結構的 wBeginDay、wBeginMonth 和 wBeginYear 成員必須分別設定為有效的日、月和年。

工作可以有任意數目的觸發程式與其相關聯。 工作執行的時間是針對該工作所定義之所有觸發程式的聯集。

若要使用這些新的觸發程式設定來更新工作，應用程式必須在呼叫 SetTrigger 之後呼叫 IPersistFile：：Save 方法。

範例

下列程式代碼顯示這個方法的變數宣告和呼叫語法，包括 TASK_TRIGGER的必要成員。 在建立新觸發程式時設定觸發條件，請參閱 建立新的觸發程式。

HRESULT hr = S_OK;

TASK_TRIGGER Trigger;

ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));

Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;

// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
   printf("Failed SetTrigger\n");
   exit(1);
}

規格需求

需求	值
最低支援的用戶端	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

ITaskTrigger

ITaskTrigger：：GetTrigger

TASK_TRIGGER