PowerGetActiveScheme function (powersetting.h)

Retrieves the active power scheme and returns a GUID that identifies the scheme.


DWORD PowerGetActiveScheme(
  [in, optional] HKEY UserRootPowerKey,
  [out]          GUID **ActivePolicyGuid


[in, optional] UserRootPowerKey

This parameter is reserved for future use and must be set to NULL.

[out] ActivePolicyGuid

A pointer that receives a pointer to a GUID structure. Use the LocalFree function to free this memory.

Return value

Returns ERROR_SUCCESS (zero) if the call was successful, and a nonzero value if the call failed.


Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header powersetting.h
Library PowrProf.lib
DLL PowrProf.dll

See also

Power Management Functions