PowerImportPowerScheme function (powrprof.h)

Imports a power scheme from a file.

Syntax

DWORD PowerImportPowerScheme(
  [in]      HKEY    RootPowerKey,
  [in]      LPCWSTR ImportFileNamePath,
  [in, out] GUID    **DestinationSchemeGuid
);

Parameters

[in] RootPowerKey

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

[in] ImportFileNamePath

The path to a power scheme backup file created by PowerCfg.Exe /Export.

[in, out] DestinationSchemeGuid

A pointer to a pointer to a GUID. If the pointer contains NULL, the function allocates memory for a new GUID and puts the address of this memory in the pointer. The caller can free this memory using LocalFree.

Return value

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

Requirements

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

See also

Power Management Functions