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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Die Argumente sind ungültig. |
|
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 |