IScheduledWorkItem-Schnittstelle (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 .] ]
Stellt die Methoden zum Verwalten bestimmter Arbeitselemente bereit.
Vererbung
Die IScheduledWorkItem-Schnittstelle erbt von der IUnknown-Schnittstelle . IScheduledWorkItem verfügt auch über folgende Membertypen:
Methoden
Die IScheduledWorkItem-Schnittstelle verfügt über diese Methoden.
| IScheduledWorkItem::CreateTrigger Erstellt einen Trigger für das Arbeitselement. |
| IScheduledWorkItem::D eleteTrigger Löscht einen Trigger aus einem Arbeitselement. |
| IScheduledWorkItem::EditWorkItem Zeigt die Eigenschaftenseiten Aufgabe, Zeitplan und Einstellungen für das Arbeitselement an, sodass ein Benutzer die Eigenschaften auf diesen Seiten festlegen kann. |
| IScheduledWorkItem::GetAccountInformation Ruft den Kontonamen für das Arbeitselement ab. |
| IScheduledWorkItem::GetComment Ruft den Kommentar für das Arbeitselement ab. |
| IScheduledWorkItem::GetCreator Ruft den Namen des Erstellers des Arbeitselements ab. |
| IScheduledWorkItem::GetErrorRetryCount Ruft die Häufigkeit ab, mit der der Taskplaner einen Vorgang wiederholt, wenn ein Fehler auftritt. Diese Methode ist nicht implementiert. |
| IScheduledWorkItem::GetErrorRetryInterval Ruft das Zeitintervall in Minuten zwischen den Versuchen des Taskplaners ab, ein Arbeitselement auszuführen, wenn ein Fehler auftritt. Diese Methode ist nicht implementiert. |
| IScheduledWorkItem::GetExitCode Ruft den letzten Exitcode ab, der von der ausführbaren Datei zurückgegeben wurde, die dem Arbeitselement bei der letzten Ausführung zugeordnet ist. Die -Methode gibt auch den Exitcode zurück, der beim letzten Versuch, das Arbeitselement auszuführen, an den Taskplaner zurückgegeben wurde. |
| IScheduledWorkItem::GetFlags Ruft die Flags ab, die das Verhalten eines beliebigen Arbeitselementtyps ändern. |
| IScheduledWorkItem::GetIdleWait Ruft die Leerlaufzeit für das Arbeitselement ab. |
| IScheduledWorkItem::GetMostRecentRunTime Ruft den zeitpunkt ab, zu dem das Arbeitselement zuletzt ausgeführt wurde. |
| IScheduledWorkItem::GetNextRunTime Ruft das nächste Mal ab, wenn das Arbeitselement ausgeführt wird. |
| IScheduledWorkItem::GetRunTimes Ruft die Laufzeiten von Arbeitselementen für einen angegebenen Zeitraum ab. |
| IScheduledWorkItem::GetStatus Ruft die status des Arbeitselements ab. |
| IScheduledWorkItem::GetTrigger Ruft einen Tasktrigger ab. |
| IScheduledWorkItem::GetTriggerCount Ruft die Anzahl der Trigger für das aktuelle Arbeitselement ab. |
| IScheduledWorkItem::GetTriggerString Ruft eine Zeichenfolge ab, die den Arbeitselementtrigger beschreibt. |
| IScheduledWorkItem::GetWorkItemData Ruft anwendungsdefinierte Daten ab, die dem Arbeitselement zugeordnet sind. |
| IScheduledWorkItem::Run Sendet eine Anforderung an den Aufgabenplanungsdienst, um das Arbeitselement auszuführen. |
| IScheduledWorkItem::SetAccountInformation Legt den Kontonamen und das Kennwort fest, die zum Ausführen des Arbeitselements verwendet werden. |
| IScheduledWorkItem::SetComment Legt den Kommentar für das Arbeitselement fest. |
| IScheduledWorkItem::SetCreator Legt den Namen des Erstellers des Arbeitselements fest. |
| IScheduledWorkItem::SetErrorRetryCount Legt fest, wie oft der Taskplaner versucht, das Arbeitselement erneut auszuführen, wenn ein Fehler auftritt. Diese Methode ist nicht implementiert. |
| IScheduledWorkItem::SetErrorRetryInterval Legt das Zeitintervall in Minuten zwischen den Versuchen des Taskplaners fest, ein Arbeitselement auszuführen, nachdem ein Fehler auftritt. Diese Methode ist nicht implementiert. |
| IScheduledWorkItem::SetFlags Legt die Flags fest, die das Verhalten eines beliebigen Arbeitselementtyps ändern. |
| IScheduledWorkItem::SetIdleWait Legt die Minuten fest, in denen sich das System im Leerlauf befinden muss, bevor das Arbeitselement ausgeführt werden kann. |
| IScheduledWorkItem::SetWorkItemData Diese Methode speichert anwendungsdefinierte Daten, die dem Arbeitselement zugeordnet sind. |
| IScheduledWorkItem::Terminate Diese Methode beendet die Ausführung des Arbeitselements. |
Hinweise
Die IScheduledWorkItem-Schnittstelle ist die Basisschnittstelle für die ITask-Schnittstelle . Alle von IScheduledWorkItem bereitgestellten Methoden werden von der ITask-Schnittstelle geerbt und in der Regel über diese Schnittstelle aufgerufen.
Beispiele
Weitere Informationen und Beispielcode für diese Schnittstelle finden Sie unter C/C++-Codebeispiel: Beenden einer Aufgabe.
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 |
| Verteilbare Komponente | Internet Explorer 4.0 oder höher unter Windows NT 4.0 und Windows 95 |