Export (0) Print
Expand All
Expand Minimize

ReadPwrScheme function

[ReadPwrScheme 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 power policy settings that are unique to the specified power scheme.

Syntax


BOOLEAN WINAPI ReadPwrScheme(
  _In_   UINT uiID,
  _Out_  PPOWER_POLICY pPowerPolicy
);

Parameters

uiID [in]

The index of the power scheme to be read.

pPowerPolicy [out]

A pointer to a POWER_POLICY structure that receives the power policy settings.

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

If the power scheme specified does not exist, the function returns FALSE.

To retrieve information about the power policy settings currently in use by the system, call the GetActivePwrScheme function. To retrieve additional information about the current power policy settings, call the CallNtPowerInformation function.

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

PowrProf.h

Library

PowrProf.lib

DLL

PowrProf.dll

See also

Power Schemes
Power Management Functions
GetActivePwrScheme
POWER_POLICY
WritePwrScheme

 

 

Community Additions

ADD
Show:
© 2014 Microsoft