ITask::SetWorkingDirectory-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 .] ]
Diese Methode legt das Arbeitsverzeichnis für den Task fest.
Syntax
HRESULT SetWorkingDirectory(
[in] LPCWSTR pwszWorkingDirectory
);
Parameter
[in] pwszWorkingDirectory
Eine NULL-endende Zeichenfolge, die einen Verzeichnispfad zum Arbeitsverzeichnis für die Aufgabe enthält.
Die Anwendung beginnt mit diesem Verzeichnis als aktuellem Arbeitsverzeichnis. Um das Verzeichnis zu löschen, legen Sie pwszWorkingDirectory auf L"" fest. Wenn das Arbeitsverzeichnis auf L"" festgelegt ist und die Anwendung ausgeführt wird, ist das aktuelle Verzeichnis das Verzeichnis, in dem sich die ausführbare Datei des Aufgabenplanungsdiensts Mstask.exe befindet.
Rückgabewert
Die SetWorkingDirectory-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
Nachdem Sie das Arbeitsverzeichnis einer Aufgabe festgelegt haben, müssen Sie IPersistFile::Save aufrufen, um das geänderte Aufgabenobjekt auf dem Datenträger zu speichern.
Beispiele
Ein Beispiel zum Festlegen des Arbeitsverzeichnisses einer Aufgabe finden Sie unter C/C++-Codebeispiel: Festlegen des Arbeitsverzeichnisses.
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 |