Метод ITaskScheduler::AddWorkItem (mstask.h)

Статья
02/29/2024

[[Этот API может быть изменен или недоступен в последующих версиях операционной системы или продукта. Вместо этого используйте интерфейсы планировщика задач 2.0 .] ]

Метод AddWorkItem добавляет задачу в расписание задач.

Синтаксис

HRESULT AddWorkItem(
  [in] LPCWSTR            pwszTaskName,
  [in] IScheduledWorkItem *pWorkItem
);

Параметры

[in] pwszTaskName

Строка, завершающаяся значением NULL, указывающая имя добавляемой задачи. Имя задачи должно соответствовать Windows NT соглашениям об именовании файлов, но не должно включать обратную косую черту, так как вложение в объект папки задач не допускается.

[in] pWorkItem

Указатель на задачу, добавляемую в расписание.

Возвращаемое значение

Метод AddWorkItem возвращает одно из следующих значений.

Код возврата	Описание
S_OK	Операция выполнена успешно.
ERROR_FILE_EXISTS	Задача с указанным именем уже существует. Фактическое возвращаемое значение — HRESULT_FROM_WIN32(ERROR_FILE_EXISTS).
E_INVALIDARG	Один или несколько аргументов недопустимы.
E_OUTOFMEMORY	Недостаточно памяти для выполнения операции.

Планировщик задач предоставляет два метода добавления рабочих элементов: NewWorkItem и AddWorkItem. Каждый из этих методов имеет свое конкретное преимущество. AddWorkItem предотвращает конфликты именования, но также требует двух операций записи на диск для каждого вызова. Одна операция записи выполняется, когда вызов AddWorkItem создает пустой объект рабочего элемента на диске, а затем выполняется другая операция записи при вызове IPersistFile::Save .

NewWorkItem не предотвращает конфликты именования, но при вызове метода IPersistFile::Save требуется только одна операция записи диска. Несмотря на то, что newWorkItem более эффективен с операциями записи на диск, приложение рискует создать рабочий элемент с тем же именем другим приложением перед вызовом IPersistFile::Save .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	mstask.h
Библиотека	Mstask.lib
DLL	Mstask.dll
Распространяемые компоненты	Internet Обозреватель 4.0 или более поздней версии в Windows NT 4.0 и Windows 95

См. также раздел

IScheduledWorkItem

ITaskScheduler

ITaskScheduler::NewWorkItem

Share via