Примеры получения свойств рабочего элемента
Чтобы получить свойства рабочего элемента, вызовите метод ITaskScheduler::Activate , чтобы получить интерфейс объекта рабочего элемента, а затем вызовите соответствующий метод, чтобы получить интересующее вас свойство задачи. В настоящее время единственными допустимыми рабочими элементами являются задачи.
В примерах кода, перечисленных в нижней части этой страницы, показано, как получить свойства, которые применяются ко всем рабочим элементам. Сведения о других свойствах, уникальных для задач, см. в разделе Настройка примеров свойств задачи.
Примечание
В следующем примере кода все интерфейсы освобождаются после того, как они больше не нужны.
Обратите внимание, что при получении свойства строки (например, комментария для рабочего элемента) необходимо вызвать Метод CoTaskMemFree , чтобы освободить память, выделенную для возвращаемой строки.
В следующей процедуре описывается получение свойства задачи.
Получение свойства задачи
- Вызовите CoInitialize , чтобы инициализировать библиотеку COM, и CoCreateInstance , чтобы получить объект планировщика задач. (В этих примерах предполагается, что служба планировщика задач запущена.)
- Вызовите ITaskScheduler::Activate , чтобы получить интерфейс ITask объекта задачи. (Обратите внимание, что задачи в настоящее время являются единственным допустимым типом рабочего элемента.)
- Вызовите соответствующий метод, чтобы получить интересующее вас свойство.
- При необходимости обработайте свойство . (В этих примерах просто выводится свойство на экран.)
- Если возвращенное свойство является строкой, вызовите Метод CoTaskMemFree , чтобы освободить память, выделенную для возвращаемой строки.
| Пример кода | См. |
|---|---|
| Получение сведений об учетной записи известной задачи | Пример кода C/C++: получение сведений об учетной записи задачи |
| Получение строки комментария известной задачи | Пример кода C/C++: получение комментария к задаче |
| Получение имени создателя задачи и его отображение на экране | Пример кода C/C++: получение создателя задачи |
| Получение последнего кода выхода, возвращенного известной задачей | Пример кода C/C++: получение кода выхода из задачи |
| Получение времени ожидания простоя задачи и его отображение на экране | Пример кода C/C++: получение времени ожидания простоя задачи |
| Получение времени последнего выполнения задачи и ее отображение на экране | Пример кода C/C++: получение времени выполнения задачи MostRecentRun |
| Получение следующего запланированного запуска задачи и отображение этого времени на экране | Пример кода C/C++: получение времени следующего запуска задачи |
| Получение времени выполнения задачи и их отображение на экране | Пример кода C/C++: получение времени выполнения задачи |
| Получение текущего состояния задачи и его отображение на экране | Пример кода C/C++: получение состояния задачи |
Связанные темы