ITaskService::NewTask-Methode (taskschd.h)

  • Artikel

Gibt ein leeres Aufgabendefinitionsobjekt zurück, das mit Einstellungen und Eigenschaften ausgefüllt und dann mit 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 Aufgabendefinition, die alle Informationen angibt, die zum Erstellen einer neuen Aufgabe erforderlich sind.

Ü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 seiner Verwendung freigegeben werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-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 nichtzero-Wert wurde an den Flags-Parameter übergeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile taskschd.h
Bibliothek Taskschd.lib
DLL Taskschd.dll

Weitere Informationen

ITaskService