IScheduledWorkItem：：SetIdleWait 方法 (mstask.h)
[[此 API 可能會在後續版本的操作系統或產品中變更或無法使用。 請改用 工作排程器 2.0 介面 。] ]
設定系統必須閑置的分鐘數，才能執行 工作專案 。
語法
HRESULT SetIdleWait(
[in] WORD wIdleMinutes,
[in] WORD wDeadlineMinutes
);
參數
[in] wIdleMinutes
值，指定系統必須在幾分鐘內保持閑置的時間，才能執行工作專案。
[in] wDeadlineMinutes
值，指定工作排程器等候 pwIdleMinutes 中傳回的空閒時間週期的最大分鐘數。
傳回值
SetIdleWait 方法會傳回S_OK。
備註
此處指定的空閒時間會與 閑置觸發 程式和 閑置條件搭配使用。 如需詳細資訊，請參閱 工作閑置條件。 閑置觸發程式是與排程時間無關的事件型觸發程式。 相反地，閑置條件與工作的排程開始時間相關聯。
您可以將 TASK_TRIGGER TASK_TRIGGER_TYPE成員設定為TASK_EVENT_TRIGGER_ON_IDLE，以指定閑置觸發程式。 當系統在 wIdleMinutes 指定的時間量閑置時，就會引發閑置觸發程式。
您可以呼叫 IScheduledWorkItem：：SetFlags 來設定閑置條件。 如果已設定TASK_FLAG_START_ONLY_IF_IDLE旗標，只有當系統在 wIdleMinutes 所指定的時間量閑置時，工作專案才會在其排程時間執行。 工作排程器服務會等候 wDeadlineMinutes 中指定的分鐘數超過排程開始時間，以查看系統是否閒置。
應用程式必須在呼叫 SetIdleWait 之後呼叫 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 或更新版本 |