Beispiele für das Abrufen von Arbeitselementeigenschaften
Um die Eigenschaften eines Arbeitselements abzurufen, rufen Sie ITaskScheduler::Activate auf, um die Schnittstelle des Arbeitselementobjekts abzurufen, und rufen Sie dann die entsprechende Methode auf, um die gewünschte Taskeigenschaft abzurufen. Derzeit sind aufgaben die einzigen gültigen Arbeitselemente.
Die unten auf dieser Seite aufgeführten Codebeispiele zeigen, wie die Eigenschaften abgerufen werden, die für alle Arbeitselemente gelten. Weitere Eigenschaften, die für Aufgaben eindeutig sind, finden Sie unter Festlegen von Aufgabeneigenschaftenbeispielen.
Hinweis
Im folgenden Codebeispiel werden alle Schnittstellen freigegeben, nachdem sie nicht mehr benötigt werden.
Beachten Sie, dass Sie beim Abrufen einer Zeichenfolgeneigenschaft (z. B. Kommentar für ein Arbeitselement) CoTaskMemFree aufrufen müssen, um den für die zurückgegebene Zeichenfolge zugewiesenen Arbeitsspeicher freizugeben.
Im folgenden Verfahren wird beschrieben, wie eine Taskeigenschaft abgerufen wird.
So rufen Sie eine Taskeigenschaft ab
- Rufen Sie CoInitialize auf, um die COM-Bibliothek zu initialisieren, und CoCreateInstance , um ein Task Scheduler-Objekt abzurufen. (In diesen Beispielen wird davon ausgegangen, dass der Taskplanerdienst ausgeführt wird.)
- Rufen Sie ITaskScheduler::Activate auf, um die ITask-Schnittstelle des Aufgabenobjekts abzurufen. (Beachten Sie, dass Aufgaben derzeit der einzige gültige Arbeitselementtyp sind.)
- Rufen Sie die entsprechende Methode auf, um die gewünschte Eigenschaft abzurufen.
- Verarbeiten Sie die Eigenschaft nach Bedarf. (In diesen Beispielen wird einfach die Eigenschaft auf dem Bildschirm gedruckt.)
- Wenn die zurückgegebene Eigenschaft eine Zeichenfolge ist, rufen Sie CoTaskMemFree auf, um den für die zurückgegebene Zeichenfolge zugewiesenen Arbeitsspeicher freizugeben.
| Ein Codebeispiel für | Siehe |
|---|---|
| Abrufen der Kontoinformationen einer bekannten Aufgabe | C/C++-Codebeispiel: Abrufen von Aufgabenkontoinformationen |
| Abrufen der Kommentarzeichenfolge einer bekannten Aufgabe | C/C++-Codebeispiel: Abrufen eines Aufgabenkommentars |
| Abrufen des Namens des Erstellers der Aufgabe und Anzeigen auf dem Bildschirm | C/C++-Codebeispiel: Abrufen des Aufgabenerstellers |
| Abrufen des letzten Von einem bekannten Vorgang zurückgegebenen Exitcodes | C/C++-Codebeispiel: Abrufen von Vorgangsausgangscode |
| Abrufen der Leerlaufwartezeit der Aufgabe und Anzeigen auf dem Bildschirm | C/C++-Codebeispiel: Abrufen der Leerlaufzeit des Tasks |
| Abrufen des Zeitpunkts der letzten Ausführung der Aufgabe und Anzeigen auf dem Bildschirm | C/C++-Codebeispiel: Abrufen der Aufgabe MostRecentRun Time |
| Abrufen der nächsten Ausführung der Aufgabe und Anzeigen dieser Zeit auf dem Bildschirm | C/C++-Codebeispiel: Abrufen der Aufgabe "NextRun Time" |
| Abrufen der Laufzeiten der Aufgabe und Anzeigen auf dem Bildschirm | C/C++-Codebeispiel: Abrufen von Taskausführungszeiten |
| Abrufen des aktuellen status der Aufgabe und Anzeigen auf dem Bildschirm | C/C++-Codebeispiel: Abrufen des Vorgangsstatus |
Zugehörige Themen