ILogonTrigger-Schnittstelle (taskschd.h)
Stellt einen Trigger dar, der eine Aufgabe startet, wenn sich ein Benutzer anmeldet. Wenn der Aufgabenplanungsdienst gestartet wird, werden alle angemeldeten Benutzer aufgelistet, und alle Aufgaben, die mit Anmeldetriggern registriert sind, die dem angemeldeten Benutzer entsprechen, werden ausgeführt.
Vererbung
Die ILogonTrigger-Schnittstelle erbt von der ITrigger-Schnittstelle.
Methoden
Die ILogonTrigger-Schnittstelle verfügt über diese Methoden.
| ILogonTrigger::get_Delay Ruft einen Wert ab, der die Zeitspanne zwischen der Anmeldung des Benutzers und dem Start der Aufgabe angibt, oder legt diesen fest. (Abrufen) |
| ILogonTrigger::get_UserId Ruft den Bezeichner des Benutzers ab oder legt ihn fest. (Abrufen) |
| ILogonTrigger::p ut_Delay Ruft einen Wert ab, der die Zeitspanne zwischen der Anmeldung des Benutzers und dem Start der Aufgabe angibt, oder legt diesen fest. (Put) |
| ILogonTrigger::p ut_UserId Ruft den Bezeichner des Benutzers ab oder legt ihn fest. (Put) |
Hinweise
Wenn sie möchten, dass eine Aufgabe ausgelöst wird, wenn sich ein Mitglied einer Gruppe am Computer anmeldet und nicht, wenn sich ein bestimmter Benutzer anmeldet, weisen Sie der UserId-Eigenschaft keinen Wert zu. Erstellen Sie stattdessen einen Anmeldetrigger mit einer leeren UserId-Eigenschaft , und weisen Sie dem Prinzipal für die Aufgabe mithilfe der GroupId-Eigenschaft einen Wert zu.
Beim Lesen oder Schreiben von XML für eine Aufgabe wird ein Anmeldetrigger mithilfe des LogonTrigger-Elements des Taskplanerschemas angegeben.
Beispiele
Weitere Informationen und Beispielcode für diese Schnittstelle finden Sie unter Anmeldetriggerbeispiel (C++).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | taskschd.h |