ITask::SetPriority-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 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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
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 |