ITask::SetPriority-Methode (mstask.h)

  • Artikel

[[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 Priorität für die Aufgabe fest.

Syntax

HRESULT SetPriority(
  [in] DWORD dwPriority
);

Parameter

[in] dwPriority

Ein DWORD , das die Priorität für die aktuelle Aufgabe angibt. Die Priorität eines Vorgangs bestimmt die Häufigkeit und Länge der Zeitsegmente für einen Prozess. Dies gilt nur für die Betriebssysteme Windows Server 2003, Windows XP und Windows 2000. Diese Werte stammen aus der CreateProcess-Prioritätsklasse und können eines der folgenden Flags sein (in absteigender Reihenfolge der Threadplanungspriorität):

  • REALTIME_PRIORITY_CLASS
  • HIGH_PRIORITY_CLASS
  • NORMAL_PRIORITY_CLASS
  • IDLE_PRIORITY_CLASS

Rückgabewert

Die SetPriority-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.

Hinweise

Nachdem Sie die Priorität einer Aufgabe festgelegt haben, rufen Sie IPersistFile::Save auf, um das geänderte Aufgabenobjekt auf dem Datenträger zu speichern.

Beispiele

Weitere Informationen und ein Beispiel zum Festlegen der Priorität einer Aufgabe finden Sie unter C/C++-Codebeispiel: Festlegen der Aufgabenpriorität.

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

Weitere Informationen

GetPriority

Itask