若要擷取工作項目的屬性,請呼叫 ITaskScheduler::Activate 擷取工作專案對象的介面,然後呼叫適當的方法來擷取您感興趣的工作屬性。 目前,唯一有效的工作項目是任務。
此頁面底部所列的程式代碼範例示範如何擷取套用至所有工作項目的屬性。 如需工作特有的其他屬性,請參閱 設定工作屬性範例。
注意
在下列程式代碼範例中,所有介面在不再需要之後都會釋出。
請注意,如果您要擷取字串屬性(例如工作專案的批註),您必須呼叫 CoTaskMemFree,以釋放為傳回字串配置的記憶體。
下列程式描述如何擷取工作屬性。
擷取工作屬性
- 呼叫 CoInitialize 來初始化 COM 連結庫,並 CoCreateInstance 以取得 Task Scheduler 物件。 (這些範例假設工作排程器服務正在執行。)
- 呼叫 ITaskScheduler::Activate,以取得工作物件的 ITask 介面。 (請注意,工作目前是唯一有效的工作項目類型。
- 呼叫適當的方法來擷取您感興趣的屬性。
- 視需要處理 屬性。 (這些範例只會將 屬性列印到畫面。
- 如果傳回的屬性是字串,請呼叫 CoTaskMemFree,以釋放為傳回字串配置的記憶體。
| 程式碼範例 | 看 |
|---|---|
| 擷取已知任務的帳號資訊 | C/C++程式代碼範例:擷取工作帳戶資訊 |
| 擷取已知任務的註解字串 | C/C++ 程式代碼範例:擷取工作批注 |
| 擷取任務建立者的名稱,並在畫面上顯示 | C/C++程式碼範例:取得任務建立者 |
| 擷取已知工作傳回的最後一個結束代碼 | C/C++ 程式代碼範例:擷取工作結束代碼 |
| 擷取工作的閑置等候時間,並在畫面上顯示 | C/C++程式代碼範例:擷取工作閒置等候時間 |
| 擷取工作上次執行的時間,並在畫面上顯示它 | C/C++ 代碼範例:取得任務最近期執行時間 |
| 擷取下一次工作的排程時間,並將該時間顯示在螢幕上。 | C/C++ 程式代碼範例:取回任務的下一個運行時間 |
| 擷取工作的運行時間,並在畫面上顯示它們 | C/C++ 程式代碼範例:擷取工作運行時間 |
| 擷取工作的目前狀態,並在畫面上顯示它 | C/C++ 程式代碼範例:擷取工作狀態 |
相關主題