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