ITaskScheduler::AddWorkItem-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 .] ]
Die AddWorkItem-Methode fügt dem Zeitplan von Vorgängen eine Aufgabe hinzu.
Syntax
HRESULT AddWorkItem(
[in] LPCWSTR pwszTaskName,
[in] IScheduledWorkItem *pWorkItem
);
Parameter
[in] pwszTaskName
Eine NULL-endende Zeichenfolge, die den Namen der hinzuzufügenden Aufgabe angibt. Der Aufgabenname muss den Windows NT-Dateinamenkonventionen entsprechen, darf aber keine umgekehrten Schrägstriche enthalten, da das Schachteln innerhalb des Aufgabenordnerobjekts nicht zulässig ist.
[in] pWorkItem
Ein Zeiger auf den Task, der dem Zeitplan hinzugefügt werden soll.
Rückgabewert
Die AddWorkItem-Methode gibt einen der folgenden Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Eine Aufgabe mit dem angegebenen Namen ist bereits vorhanden. Der tatsächliche Rückgabewert ist HRESULT_FROM_WIN32(ERROR_FILE_EXISTS). |
|
Mindestens eines der Argumente ist ungültig. |
|
Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen. |
Hinweise
Der Aufgabenplaner bietet zwei Methoden zum Hinzufügen von Arbeitselementen: NewWorkItem und AddWorkItem. Von diesen Methoden hat jede ihren spezifischen Vorteil. AddWorkItem verhindert Namenskonflikte, erfordert aber auch zwei Schreibvorgänge pro Aufruf. Ein Schreibvorgang wird ausgeführt, wenn der Aufruf von AddWorkItem ein leeres Arbeitselementobjekt auf dem Datenträger erstellt, gefolgt von einem weiteren Schreibvorgang, wenn IPersistFile::Save aufgerufen wird.
NewWorkItem verhindert keine Namenskonflikte, erfordert jedoch nur einen Schreibvorgang, wenn IPersistFile::Save aufgerufen wird. Obwohl NewWorkItem bei Schreibvorgängen auf Datenträgern effizienter ist, besteht für die Anwendung das Risiko, dass eine andere Anwendung ein Arbeitselement mit demselben Namen erstellt, bevor der Aufruf von IPersistFile::Save erfolgt.
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 |