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
非零值传递到 标志 参数中。

要求

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

另请参阅

ITaskService