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 方法會傳回下列其中一個值。

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

備註

程序必須在呼叫 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 或更新版本

另請參閱

IScheduledWorkItem

IScheduledWorkItem：：GetFlags

IScheduledWorkItem：：SetAccountInformation