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

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

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

Синтаксис

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

Параметры

[in] pwszTaskName

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

[in] pWorkItem

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

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

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

Комментарии

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

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

Требования

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

IScheduledWorkItem

ITaskScheduler

ITaskScheduler::NewWorkItem