IScheduledWorkItem::SetFlags-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 .] ]
Legt die Flags fest, die das Verhalten eines beliebigen Arbeitselementtyps ändern.
Syntax
HRESULT SetFlags(
DWORD dwFlags
);
Parameter
dwFlags
Ein Wert, der eine Kombination aus mindestens einem der folgenden Flags angibt:
TASK_FLAG_INTERACTIVE
Dieses Flag wird beim Konvertieren von Windows NT AT-Dienstaufträgen in Arbeitselemente verwendet. Der Windows NT AT-Dienstauftrag bezieht sich auf At.exe, das Windows NT-Befehlszeilenprogramm, das zum Erstellen von Aufträgen für den Windows NT-Zeitplandienst verwendet wird. Der Taskplanerdienst ersetzt den Zeitplandienst und ist abwärtskompatibel. Die Konvertierung erfolgt, wenn der Aufgabenplaner unter Windows NT/Windows 2000 installiert ist, z. B. wenn Sie Internet Explorer 4.0 oder ein Upgrade auf Windows 2000 installieren. Während des Setupvorgangs durchsucht der Installationscode des Taskplaner die Registrierung nach Aufträgen, die für den AT-Dienst erstellt wurden, und erstellt Arbeitselemente, die denselben Vorgang ausführen.
Für solche konvertierten Aufträge wird das interaktive Flag festgelegt, wenn das Arbeitselement dem Benutzer angezeigt werden soll. Wenn dieses Flag nicht festgelegt ist, werden keine Arbeitselemente im Ordner Aufgaben angezeigt, und beim Ausführen des Arbeitselements wird dem Benutzer keine dem Arbeitselement zugeordnete Benutzeroberfläche angezeigt.
TASK_FLAG_DELETE_WHEN_DONE
Das Arbeitselement wird gelöscht, wenn keine geplanten Laufzeiten mehr vorhanden sind.
TASK_FLAG_DISABLED
Das Arbeitselement ist deaktiviert. Dies ist nützlich, um vorübergehend zu verhindern, dass ein Arbeitselement zur geplanten Zeit ausgeführt wird.
TASK_FLAG_HIDDEN
Das erstellte Arbeitselement wird ausgeblendet.
TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
Das Arbeitselement wird nur ausgeführt, wenn der in IScheduledWorkItem::SetAccountInformation angegebene Benutzer interaktiv angemeldet ist. Dieses Flag hat keine Auswirkungen auf die Arbeitselemente, die für die Ausführung im lokalen Konto festgelegt sind.
TASK_FLAG_START_ONLY_IF_IDLE
Das Arbeitselement beginnt nur, wenn der Computer zur geplanten Startzeit nicht verwendet wird.
TASK_FLAG_SYSTEM_REQUIRED
Das Arbeitselement bewirkt, dass das System fortgesetzt oder aktiviert wird, wenn das System mit Akkubetrieb ausgeführt wird. Dieses Flag wird nur auf Systemen unterstützt, die Wiederaufnahmetimer unterstützen.
TASK_FLAG_KILL_ON_IDLE_END
Das Arbeitselement wird beendet, wenn der Computer während der Ausführung des Arbeitselements einen Übergang in den Leerlauf vornimmt. Der Computer gilt erst als leer, wenn die Zeit der IdleWait-Trigger ohne Benutzereingabe verstrichen ist. Informationen zu Leerlauftriggern finden Sie unter Leerlauftrigger.
TASK_FLAG_RESTART_ON_IDLE_RESUME
Das Arbeitselement wird erneut gestartet, wenn der Computer einen Übergang ohne Leerlauf in den Leerlauf vornimmt, bevor alle task_triggers des Arbeitselements verstreichen. (Verwenden Sie dieses Flag in Verbindung mit TASK_FLAG_KILL_ON_IDLE_END.)
TASK_FLAG_DONT_START_IF_ON_BATTERIES
Das Arbeitselement wird nicht gestartet, wenn der Zielcomputer mit Akkubetrieb ausgeführt wird.
TASK_FLAG_KILL_IF_GOING_ON_BATTERIES
Das Arbeitselement wird beendet, und die zugeordnete Anwendung wird beendet, wenn der Zielcomputer des Arbeitselements zur Akkuleistung wechselt.
TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET
Das Arbeitselement wird nur ausgeführt, wenn derzeit eine gültige Internetverbindung besteht.
Rückgabewert
Die SetFlags-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
Programme müssen die IPersistFile::Save-Methode aufrufen, nachdem SetFlags aufgerufen wurde, um die Flags zu aktualisieren.
Diese Methode wird verwendet, um die Flags festzulegen, die von einem beliebigen Typ von geplanten Arbeitselementen verwendet werden. Im Gegensatz dazu wird ITask::SetTaskFlags nur zum Festlegen von Flags verwendet, die von geplanten Aufgaben verwendet werden.
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 |