ITriggerCollection::Create-Methode (taskschd.h)

  • Artikel

Erstellt einen neuen Trigger für den Task.

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 die Aufgabe zu einer bestimmten Tageszeit aus.
TASK_TRIGGER_DAILY
2
 Löst die Aufgabe nach einem tagesaktuellen Zeitplan aus. Beispielsweise beginnt die Aufgabe jeden Tag zu einer bestimmten Zeit, jeden zweiten Tag, jeden dritten Tag usw.
TASK_TRIGGER_WEEKLY
3
 Löst die Aufgabe nach einem wöchentlichen Zeitplan aus. Beispielsweise beginnt die Aufgabe jede Woche oder eine andere Woche um 8:00 Uhr an einem bestimmten Tag.
TASK_TRIGGER_MONTHLY
4
 Löst den Task nach einem monatlichen Zeitplan aus. Beispielsweise beginnt die Aufgabe an bestimmten Tagen bestimmter Monate.
TASK_TRIGGER_MONTHLYDOW
5
 Löst den Task nach einem monatlichen Wochentagszeitplan aus. Beispielsweise beginnt die Aufgabe an einem bestimmten Wochentag, an wochenspezifischen Wochentagen 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 Task aus, wenn der Task 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 Zeiger ohne NULL kann zu einem Speicherverlust führen, da der Zeiger überschrieben wird.

Rückgabewert

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

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

ITriggerCollection

Aufgabenplanung