IScheduledWorkItem：：SetFlags 方法 (mstask.h)
[[此 API 可能會在後續版本的操作系統或產品中變更或無法使用。 請改用 工作排程器 2.0 介面 。] ]
設定修改任何類型的 工作項目行為的旗標。
語法
HRESULT SetFlags(
DWORD dwFlags
);
參數
dwFlags
值，指定下列一或多個旗標的組合：
TASK_FLAG_INTERACTIVE
將AT服務作業 Windows NT轉換成工作專案時，會使用此旗標。 Windows NT AT 服務作業是指 At.exe，Windows NT 命令行公用程式，用於建立 Windows NT 排程服務的作業。 工作排程器服務會取代排程服務，並與它回溯相容。 當工作排程器安裝在 Windows NT/Windows 2000 時，就會進行轉換，例如，如果您安裝 Internet Explorer 4.0 或升級至 Windows 2000。 在安裝過程中，工作排程器安裝程式代碼會搜尋登錄中為AT服務建立的工作，並建立工作專案以完成相同的作業。
針對這類轉換的作業，如果工作專案是要向用戶顯示，則會設定互動式旗標。 未設定此旗標時，[工作] 資料夾中不會顯示任何工作專案，而且在執行工作專案時，不會向用戶顯示與工作專案相關聯的使用者介面。
TASK_FLAG_DELETE_WHEN_DONE
當沒有更多排程的運行時間時，將會刪除工作專案。
TASK_FLAG_DISABLED
工作專案已停用。 這適用於暫時防止工作專案在排程時間 () 執行。
TASK_FLAG_HIDDEN
建立的工作專案將會隱藏。
TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
只有在 IScheduledWorkItem：：SetAccountInformation 中指定的使用者以互動方式登入時，才會執行工作專案。 此旗標不會影響設定為在本機帳戶中執行的工作專案。
TASK_FLAG_START_ONLY_IF_IDLE
只有在電腦不在排程開始時間使用時，才會開始工作專案。
TASK_FLAG_SYSTEM_REQUIRED
如果系統在電池電力上執行，工作專案會導致系統繼續或喚醒。 只有支援繼續定時器的系統上才支援此旗標。
TASK_FLAG_KILL_ON_IDLE_END
如果計算機在執行工作專案時閑置到非閑置轉換，工作專案就會終止。 在 IdleWait 觸發程式的時間經過且沒有使用者輸入之前，計算機不會被視為閑置。 如需閑置觸發程式的相關信息，請參閱 閑置觸發程式。
TASK_FLAG_RESTART_ON_IDLE_RESUME
如果計算機在經過所有工作專案 task_triggers 之前進行非閑置到閑置轉換，工作專案就會再次啟動。 (將此旗標與 TASK_FLAG_KILL_ON_IDLE_END.) 搭配使用
TASK_FLAG_DONT_START_IF_ON_BATTERIES
如果工作專案的目標計算機正在電池電力上執行，工作專案就不會啟動。
TASK_FLAG_KILL_IF_GOING_ON_BATTERIES
工作項目結束時，如果工作專案的目標計算機切換為電池電源，相關聯的應用程式就會結束。
TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET
只有在目前有有效的因特網連線時，工作專案才會執行。
傳回值
SetFlags 方法會傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
作業成功。 |
|
自變數無效。 |
|
記憶體不足。 |
備註
程序必須在呼叫 SetFlags 之後呼叫 IPersistFile：：Save 方法，才能更新旗標。
這個方法可用來設定任何類型的排程工作專案所使用的旗標。 相反地， ITask：：SetTaskFlags 只會用來設定排程工作所使用的旗標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mstask.h |
| 程式庫 | Mstask.lib |
| Dll | Mstask.dll |
| 可轉散發套件 | Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本 |