ITaskService::NewTask メソッド (taskschd.h)

設定とプロパティを入力し、ITaskFolder::RegisterTaskDefinition メソッドを使用して登録する空のタスク定義オブジェクトを返します。

構文

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

パラメーター

[in] flags

このパラメーターは将来使用するために予約されており、0 に設定する必要があります。

[out] ppDefinition

新しいタスクの作成に必要なすべての情報を指定するタスク定義。

ITaskDefinition インターフェイス ポインターNULL への参照を渡します。 NULL 以外のポインターを参照すると、ポインターが上書きされるため、メモリ リークが発生する可能性があります。

ITaskDefinition ポインター 返されるポインターは、使用後に解放する必要があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

戻りコード/値 形容
S_OK
0x0
このメソッドはエラーなしで正常に返されました。
E_POINTER
0x80004003
null は、ppDefinition パラメーターに渡されました。 ITaskDefinition インターフェイス ポインターNULL への参照を渡します。
E_INVALIDARG
0x80070057
パラメーター フラグに 0 以外の値が渡されました。

必要条件

要件 価値
サポートされる最小クライアント Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2008 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー taskschd.h
ライブラリ Taskschd.lib
DLL Taskschd.dll

関連項目

ITaskService の