IActionCollection::Create-Methode (taskschd.h)

Artikel
07/16/2024

Erstellt und fügt der Auflistung eine neue Aktion hinzu.

Syntax

HRESULT Create(
  [in]  TASK_ACTION_TYPE type,
  [out] IAction          **ppAction
);

Parameter

[in] type

Dieser Parameter wird auf eine der folgenden TASK_ACTION_TYPE Enumerationskonstanten festgelegt.

Wert	Bedeutung
TASK_ACTION_EXEC 0	Die Aktion führt einen Befehlszeilenvorgang aus. Die Aktion kann z. B. ein Skript ausführen, eine ausführbare Datei starten oder, wenn der Name eines Dokuments angegeben wird, die zugehörige Anwendung suchen und die Anwendung mit dem Dokument starten.
TASK_ACTION_COM_HANDLER 5	Die Aktion löst einen Handler aus.
TASK_ACTION_SEND_EMAIL 6	Diese Aktion sendet eine E-Mail-Nachricht.
TASK_ACTION_SHOW_MESSAGE 7	Diese Aktion zeigt ein Meldungsfeld an.

[out] ppAction

Eine IAction Schnittstelle, die die neue Aktion darstellt.

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

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Sie können der Sammlung nicht mehr als 32 Aktionen hinzufügen.

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