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
程式庫 Taskschd.lib
Dll Taskschd.dll

另請參閱

ITaskService