IEventTrigger-Schnittstelle (taskschd.h)

Artikel
03/15/2023

Stellt einen Trigger dar, der einen Task startet, wenn ein Systemereignis auftritt.

Vererbung

Die IEventTrigger-Schnittstelle erbt von der ITrigger-Schnittstelle.

Methoden

Die IEventTrigger-Schnittstelle verfügt über diese Methoden.


IEventTrigger::get_Delay Ruft einen Wert ab, der die Zeitspanne zwischen dem Auftreten des Ereignisses und dem Start der Aufgabe angibt, oder legt diesen fest. (Abrufen)
IEventTrigger::get_Subscription Ruft eine Abfragezeichenfolge ab, die das Ereignis identifiziert, das den Trigger auslöst, oder legt diese fest. (Abrufen)
IEventTrigger::get_ValueQueries Ruft eine Auflistung von benannten XPath-Abfragen ab oder legt diese fest. Jede Abfrage in der Auflistung wird auf die letzte übereinstimmende Ereignis-XML angewendet, die von der in der Subscription-Eigenschaft angegebenen Abonnementabfrage zurückgegeben wird. (Abrufen)
IEventTrigger::p ut_Delay Ruft einen Wert ab, der die Zeitspanne zwischen dem Auftreten des Ereignisses und dem Start der Aufgabe angibt, oder legt diesen fest. (Put)
IEventTrigger::p ut_Subscription Ruft eine Abfragezeichenfolge ab, die das Ereignis identifiziert, das den Trigger auslöst, oder legt diese fest. (Put)
IEventTrigger::p ut_ValueQueries Ruft eine Auflistung von benannten XPath-Abfragen ab oder legt diese fest. Jede Abfrage in der Auflistung wird auf die letzte übereinstimmende Ereignis-XML angewendet, die von der in der Subscription-Eigenschaft angegebenen Abonnementabfrage zurückgegeben wird. (Put)

Bemerkungen

Es können maximal 500 Aufgaben mit Ereignisabonnements erstellt werden. Ein Ereignisabonnement, das eine Vielzahl von Ereignissen abfragt, kann verwendet werden, um eine Aufgabe auszulösen, die dieselbe Aktion als Reaktion auf die protokollierten Ereignisse verwendet.

Beim Lesen oder Schreiben ihres eigenen XML-Codes für eine Aufgabe wird ein Ereignistrigger mithilfe des EventTrigger-Elements des Taskplanerschemas angegeben.

Beispiele

Weitere Informationen und Beispielcode für diese Schnittstelle finden Sie unter Ereignistriggerbeispiel (C++).

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	taskschd.h