ReadGlobalPwrPolicy function (powrprof.h)

[ReadGlobalPwrPolicy is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. See Remarks.]

Retrieves the current global power policy settings.

Syntax

BOOLEAN ReadGlobalPwrPolicy(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

Parameters

[out] pGlobalPowerPolicy

A pointer to a GLOBAL_POWER_POLICY structure that receives the information.

Return value

If the function succeeds, the return value is nonzero.

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

Remarks

The GLOBAL_POWER_POLICY structure contains policy settings that are common to all power schemes. This structure contains both user and computer policy settings.

Starting with Windows Vista, use the PowerEnumerate function to enumerate power settings for a specified scheme and the power read functions to retrieve individual settings.

For more information on using PowrProf.h, see Power Schemes.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header powrprof.h
Library PowrProf.lib
DLL PowrProf.dll

See also

GLOBAL_POWER_POLICY

Power Management Functions

WriteGlobalPwrPolicy