ITask::SetApplicationName-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 weist der aktuellen Aufgabe eine bestimmte Anwendung zu.
Syntax
HRESULT SetApplicationName(
[in] LPCWSTR pwszApplicationName
);
Parameter
[in] pwszApplicationName
Eine NULL-Zeichenfolge, die den Namen der Anwendung enthält, die der Aufgabe zugeordnet wird. Verwenden Sie eine leere Zeichenfolge, um den Anwendungsnamen zu löschen.
Rückgabewert
Die SetApplicationName-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 Sie keinen Pfad für die Anwendung angeben, durchsucht der Taskplaner den Umgebungspfad, um den richtigen Pfad zu finden. Wenn der Anwendungsname ein Programm angibt, sollte der Name die .exe-Erweiterung verwenden, um sicherzustellen, dass das Symbol der Anwendung auf der Benutzeroberfläche des Taskplaners ordnungsgemäß angezeigt wird.
Nachdem Sie SetApplicationName aufgerufen haben, stellen Sie sicher, dass Sie IPersistFile::Save aufrufen, um die geänderte Aufgabe auf dem Datenträger zu speichern.
Beispiele
Ein Beispiel zum Festlegen des Anwendungsnamens finden Sie unter C/C++-Codebeispiel: Festlegen des Anwendungsnamens.
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 |