Freigeben über


Erstellen eines neuen Triggers

Um einen Trigger zu erstellen, müssen Sie drei Schnittstellen verwenden. IScheduledWorkItem stellt die IScheduledWorkItem::CreateTrigger-Methode zum Erstellen des Triggerobjekts bereit, ITaskTrigger stellt die ITaskTrigger::SetTrigger-Methode zum Festlegen der Kriterien für den Trigger bereit, und die COM-Schnittstelle IPersistFile stellt eine Save-Methode zum Speichern des neuen Triggers auf dem Datenträger bereit.

Im folgenden Verfahren wird beschrieben, wie Sie einen neuen Trigger erstellen.

So erstellen Sie einen neuen Trigger

  1. Rufen Sie CoInitialize auf, um die COM-Bibliothek zu initialisieren, und CoCreateInstance , um ein Aufgabenplanungsobjekt abzurufen. (In diesem Beispiel wird davon ausgegangen, dass der Taskplaner-Dienst ausgeführt wird.)
  2. Rufen Sie ITaskScheduler::Activate auf, um die ITask-Schnittstelle des Aufgabenobjekts abzurufen. (Beachten Sie, dass in diesem Beispiel der Task "Testtask" abgerufen wird.)
  3. Rufen Sie CreateTrigger auf, um ein Triggerobjekt zu erstellen. (Beachten Sie, dass CreateTrigger von IScheduledWorkItem geerbt wird.)
  4. Definieren Sie eine TASK_TRIGGER-Struktur . Beachten Sie, dass wBeginDay-, wBeginMonth- und wBeginYear-Member von TASK_TRIGGER auf einen gültigen Tag, Monat bzw. Ein gültiges Jahr festgelegt werden müssen.
  5. Rufen Sie ITaskTrigger::SetTrigger auf, um die Triggerkriterien festzulegen.
  6. Speichern Sie die Aufgabe mit dem neuen Trigger mithilfe von IPersistFile::Save auf dem Datenträger. (Die IPersistFile-Schnittstelle ist eine standardmäßige COM-Schnittstelle, die von der ITask-Schnittstelle unterstützt wird.)
  7. Rufen Sie Release auf, um alle Ressourcen freizugeben. (Beachten Sie, dass Release eine IUnknown-Methode ist, die von ITask geerbt wird.)
Ein Codebeispiel für Siehe
Erstellen eines neuen Triggers für eine vorhandene Aufgabe C/C++-Codebeispiel: Erstellen eines Tasktriggers

 

Beispiele für Taskplaner 1.0