IScheduledWorkItem::D eleteTrigger-Methode (mstask.h)

[[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 .] ]

Löscht einen Trigger aus einem Arbeitselement.

Syntax

HRESULT DeleteTrigger(
  [in] WORD iTrigger
);

Parameter

[in] iTrigger

Ein Triggerindexwert, der den zu löschenden Trigger angibt. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

Die DeleteTrigger-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

Für jeden Trigger wird beim Erstellen des Triggers ein Triggerindex erstellt. Es ist jedoch kein eindeutiger Bezeichner für einen bestimmten Trigger. Wenn Sie beispielsweise vier Trigger erstellen, werden diese von 0 bis 3 nummeriert. Wenn der zweite Trigger jedoch gelöscht wird, werden die verbleibenden Trigger 0 bis 2 nummeriert. Beachten Sie, dass der Index des ersten Triggers immer 0 ist und der Index des letzten Triggers eins kleiner ist als die Gesamtzahl der Trigger für das Arbeitselement (TriggerCount -1).

Sie können die Triggeranzahl mithilfe von IScheduledWorkItem::GetTriggerCount abrufen.

Um das Löschen des Triggers abzuschließen, müssen Programme die IPersistFile::Save-Methode aufrufen, nachdem DeleteTrigger aufgerufen wurde. Das Aufrufen von IPersistFile::Save speichert die Änderungen auf dem Datenträger.

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

Weitere Informationen

CreateTrigger

IScheduledWorkItem

IScheduledWorkItem::GetTriggerCount