Метод ITaskService::NewTask (taskschd.h)

Статья
07/16/2024

Возвращает пустой объект определения задачи, который будет заполнен параметрами и свойствами, а затем зарегистрирован с помощью метода ITaskFolder::RegisterTaskDefinition.

Синтаксис

HRESULT NewTask(
  [in]  DWORD           flags,
  [out] ITaskDefinition **ppDefinition
);

Параметры

[in] flags

Этот параметр зарезервирован для дальнейшего использования и должен иметь значение 0.

[out] ppDefinition

Определение задачи, указывающее все сведения, необходимые для создания новой задачи.

Передайте ссылку на указатель интерфейса NULLITaskDefin ition. Ссылка на указатель, отличный от NULL, может привести к утечке памяти, так как указатель будет перезаписан.

Возвращенный указатель ITaskDefinition должен быть выпущен после его использования.

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

Этот метод может возвращать одно из этих значений.

Возврат кода или значения	Описание
S_OK 0x0	Метод успешно вернулся без ошибки.
E_POINTER 0x80004003	значение NULL передано в параметр ppDefinition. Передайте ссылку на указатель интерфейса NULLITaskDefin ition.
E_INVALIDARG 0x80070057	Значение, отличное от нуля, было передано в флаги параметре.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	taskschd.h
библиотеки	Taskschd.lib
DLL	Taskschd.dll

См. также

ITaskService

Поделиться через