Freigeben über


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
S_OK
Der Vorgang wurde durchgeführt.
E_INVALIDARG
Die Argumente sind ungültig.
E_OUTOFMEMORY
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

Weitere Informationen

GetApplicationName

Itask