ITask::SetParameters-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 die Befehlszeilenparameter für den Task fest.
Syntax
HRESULT SetParameters(
[in] LPCWSTR pwszParameters
);
Parameter
[in] pwszParameters
Eine NULL-endende Zeichenfolge, die Taskparameter enthält. Diese Parameter werden als Befehlszeilenargumente an die Anwendung übergeben, die von der Aufgabe ausgeführt wird. Um die Befehlszeilenparametereigenschaft zu löschen, legen Sie pwszParameters auf L"" fest.
Rückgabewert
Die SetParameters-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
Wenn dem Task eine Anwendung zugeordnet ist, werden die task-Parameter ignoriert, die von dieser Methode festgelegt werden.
Nachdem Sie die Parameter der 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 von Parametern finden Sie unter C/C++-Codebeispiel: Festlegen von Aufgabenparametern.
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 |