GetProcessPriorityBoost-Funktion (processthreadsapi.h)

  • Artikel

Ruft den Steuerungsstatus der Prioritätsverstärkung des angegebenen Prozesses ab.

Syntax

BOOL GetProcessPriorityBoost(
  [in]  HANDLE hProcess,
  [out] PBOOL  pDisablePriorityBoost
);

Parameter

[in] hProcess

Ein Handle für den Prozess. Dieses Handle muss über das PROCESS_QUERY_INFORMATION - oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das Zugriffsrecht PROCESS_QUERY_INFORMATION verfügen.

[out] pDisablePriorityBoost

Ein Zeiger auf eine Variable, die den Steuerungsstatus der Prioritätserhöhung empfängt. Der Wert TRUE gibt an, dass die dynamische Verstärkung deaktiviert ist. Der Wert FALSE gibt ein normales Verhalten an.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. In diesem Fall empfängt die Variable, auf die der pDisablePriorityBoost-Parameter verweist, den Prioritätsschubsteuerungszustand.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile processthreadsapi.h (include Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Prioritätsverstärkungen

Prozess- und Threadfunktionen

Prozesse

Planungsprioritäten

SetProcessPriorityBoost