IScheduledWorkItem::CreateTrigger-Methode (mstask.h)

Artikel
08/25/2023

[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]

Erstellt einen Trigger für das Arbeitselement.

Syntax

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

Parameter

[out] piNewTrigger

Ein Zeiger auf den zurückgegebenen Triggerindexwert des neuen Triggers. Der Triggerindex für den ersten Trigger, der einem Arbeitselement zugeordnet ist, ist "0". Weitere Verwendungsmöglichkeiten des Triggerindex finden Sie unter Hinweise.

[out] ppTrigger

Ein Zeiger auf einen Zeiger auf eine ITaskTrigger-Schnittstelle . Derzeit werden nur Aufgaben unterstützt.

Rückgabewert

Die CreateTrigger-Methode gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde durchgeführt.
E_INVALIDARG	Die Argumente sind ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Sie verwenden den von piNewTrigger zurückgegebenen Triggerindex, wenn Sie Trigger entweder abrufen oder löschen. Der Triggerindex ist jedoch kein Bezeichner. Es gibt nur die Position des neuen Triggers relativ zu den anderen aktuellen Triggern an, die dem Arbeitselement zugeordnet sind.

Um die Kriterien für den neuen Trigger festzulegen, rufen Sie ITaskTrigger::SetTrigger auf.

Nach dem Erstellen eines neuen Triggers für ein Arbeitselement müssen Anwendungen die IPersistFile::Save-Methode aufrufen, um den neuen Trigger auf dem Datenträger zu speichern.

Beispiele

Ein Beispiel zum Festlegen der Triggerkriterien beim Erstellen eines neuen Triggers finden Sie unter Erstellen eines neuen Triggers.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mstask.h
Bibliothek	Mstask.lib
DLL	Mstask.dll
Verteilbare Komponente	Internet Explorer 4.0 oder höher unter Windows NT 4.0 und Windows 95