使用 NewWorkItem 範例建立工作

  • 發行項

建立工作時，您將使用兩個工作排程器介面： ITaskScheduler 和 ITask。 您必須提供工作的唯一名稱、工作物件的類別識別碼，以及 ITask的介面識別碼。 本主題後面的程式碼範例會顯示類別識別碼和介面識別碼。

注意

您也可以呼叫 ITaskScheduler：：AddWorkItem來建立工作。 當您採用此路由時，您必須負責建立 Task 物件的實例 (支援 ITask 介面) ，然後使用您提供的名稱新增工作。

 

注意

根據預設，只有系統管理員、備份操作員或伺服器操作員群組的成員可以在 Windows Server 2003 上建立工作。 Administrators 群組的成員可能會變更 Windows\Task 資料夾的安全性描述元，讓其他人建立工作。

 

您為工作提供的名稱在 [排程的工作] 資料夾中必須是唯一的。 如果具有相同名稱的工作已經存在， ITaskScheduler：：NewWorkItem 會傳回ERROR_FILE_EXISTS。 如果您取得這個傳回值，您應該指定不同的名稱，然後再次嘗試建立工作。

下列程式描述如何建立新的工作專案工作。

建立新的工作專案工作

  1. 呼叫 CoInitialize 以初始化 COM 程式庫和 CoCreateInstance 以取得工作排程器物件。 (此範例假設工作排程器服務正在執行。)
  2. 呼叫 ITaskScheduler：：NewWorkItem 以建立新的工作。 (此方法會傳回 ITask 介面的指標。)
  3. 呼叫 IPersistFile：：Save，將新工作儲存到磁片。 (IPersistFile 介面是 ITask 介面支援的標準 COM 介面。)
  4. 呼叫 ITask：：Release 以釋放所有資源。 (請注意，Release是ITask.) 繼承的IUnknown方法
如需 的程式碼範例 請參閱
建立單一工作 C/C++ 程式碼範例：使用 NewWorkItem 建立工作

 

工作排程器 1.0 範例