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 |
---|---|
|
Die Methode wurde ohne Fehler erfolgreich zurückgegeben. |
|
NULL- wurde an den ppDefinition Parameter übergeben. Übergeben Sie einen Verweis auf einen NULL-ITaskDefinition- Schnittstellenzeiger. |
|
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 |