GetProcessPriorityBoost

The GetProcessPriorityBoost function retrieves the priority boost control state of the specified process.

BOOL GetProcessPriorityBoost(
  HANDLE hProcess,             // handle to process
  PBOOL pDisablePriorityBoost  // priority boost state
);

Parameters

hProcess

[in] Handle to the process. This handle must have the PROCESS_QUERY_INFORMATION access right. For more information, see Process Security and Access Rights.

pDisablePriorityBoost

[out] Pointer to a variable that receives the priority boost control state. A value of TRUE indicates that dynamic boosting is disabled. A value of FALSE indicates normal behavior.

Return Values

If the function succeeds, the return value is nonzero. In that case, the variable pointed to by the pDisablePriorityBoost parameter receives the priority boost control state.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Winbase.h; include Windows.h.
  Library: Use Kernel32.lib.

See Also

Processes and Threads Overview, Process and Thread Functions, SetProcessPriorityBoost