ITaskService::NewTask 方法 (taskschd.h)

返回一个空任务定义对象,该对象使用设置和属性填充,然后使用 ITaskFolder::RegisterTaskDefinition 方法注册。

语法

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

参数

[in] flags

此参数保留供将来使用,必须设置为 0。

[out] ppDefinition

指定创建新任务所需的所有信息的任务定义。

传入对 NULLITaskDefinition 接口指针的引用。 引用非 NULL 指针可能会导致内存泄漏,因为指针将被覆盖。

返回的 ITaskDefinition 指针在使用后必须释放它。

返回值

此方法可以返回其中一个值。

返回代码/值 说明
S_OK
0x0
方法已成功返回,没有错误。
E_POINTER
0x80004003
NULL 已传递到 ppDefinition 参数。 传入对 NULLITaskDefinition 接口指针的引用。
E_INVALIDARG
0x80070057
非零值已传递到 flags 参数中。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

另请参阅

ITaskService