ITriggerCollection::Create-Methode (taskschd.h)

Artikel
2024-07-16

Erstellt einen neuen Trigger für den Vorgang.

Syntax

HRESULT Create(
  [in]  TASK_TRIGGER_TYPE2 type,
  [out] ITrigger           **ppTrigger
);

Parameter

[in] type

Dieser Parameter wird auf eine der folgenden TASK_TRIGGER_TYPE2 Enumerationskonstanten festgelegt.

Wert	Bedeutung
TASK_TRIGGER_EVENT 0	Löst die Aufgabe aus, wenn ein bestimmtes Ereignis auftritt.
TASK_TRIGGER_TIME 1	Löst den Vorgang zu einer bestimmten Tageszeit aus.
TASK_TRIGGER_DAILY 2	Löst den Vorgang in einem täglichen Zeitplan aus. Beispielsweise beginnt der Vorgang jeden Tag, jeden zweiten Tag, jeden dritten Tag usw. zu einer bestimmten Zeit.
TASK_TRIGGER_WEEKLY 3	Löst den Vorgang in einem wöchentlichen Zeitplan aus. Beispielsweise beginnt der Vorgang um 8:00 Uhr an einem bestimmten Tag pro Woche oder einer anderen Woche.
TASK_TRIGGER_MONTHLY 4	Löst den Vorgang in einem monatlichen Zeitplan aus. Beispielsweise beginnt der Vorgang an bestimmten Tagen bestimmter Monate.
TASK_TRIGGER_MONTHLYDOW 5	Löst den Vorgang für einen monatlichen Wochenplan aus. Beispielsweise beginnt der Vorgang an einem bestimmten Wochentag, Wochen des Monats und Monaten des Jahres.
TASK_TRIGGER_IDLE 6	Löst die Aufgabe aus, wenn der Computer in einen Leerlaufzustand wechselt.
TASK_TRIGGER_REGISTRATION 7	Löst den Vorgang aus, wenn der Vorgang registriert ist.
TASK_TRIGGER_BOOT 8	Löst die Aufgabe aus, wenn der Computer gestartet wird.
TASK_TRIGGER_LOGON 9	Löst die Aufgabe aus, wenn sich ein bestimmter Benutzer anmeldet.
TASK_TRIGGER_SESSION_STATE_CHANGE 11	Löst die Aufgabe aus, wenn sich ein bestimmter Sitzungszustand ändert.

[out] ppTrigger

Eine ITrigger- Schnittstelle, die den neuen Trigger darstellt.

Übergeben Sie einen Verweis auf einen NULL-ITrigger- 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.

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

ITriggerCollection-

Aufgabenplaner-

Freigeben über