ITaskService::NewTask-Methode (taskschd.h)

Gibt ein leeres Aufgabendefinitionsobjekt zurück, das mit Einstellungen und Eigenschaften ausgefüllt und dann mithilfe der ITaskFolder::RegisterTaskDefinition-Methode registriert wird.

Syntax

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

Parameter

[in] flags

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf 0 festgelegt werden.

[out] ppDefinition

Die Vorgangsdefinition, die alle zum Erstellen einer neuen Aufgabe erforderlichen Informationen angibt.

Übergeben Sie einen Verweis auf einen NULL-ITaskDefinition- Schnittstellenzeiger. Das Verweisen auf einen Nicht-NULL-Zeiger kann zu einem Speicherverlust führen, da der Zeiger überschrieben wird.

Der zurückgegebene ITaskDefinition- Zeiger muss nach der Verwendung freigegeben werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Zurückgeben von Code/Wert Beschreibung
S_OK
0x0
Die Methode wurde ohne Fehler erfolgreich zurückgegeben.
E_POINTER
0x80004003
NULL- wurde an den ppDefinition Parameter übergeben. Übergeben Sie einen Verweis auf einen NULL-ITaskDefinition- Schnittstellenzeiger.
E_INVALIDARG
0x80070057
Ein Wert ungleich Null wurde an die Flags Parameter übergeben.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2008 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- taskschd.h
Library Taskschd.lib
DLL- Taskschd.dll

Siehe auch

ITaskService-