PowerDuplicateScheme function
Duplicates an existing power scheme.
Syntax
DWORD WINAPI PowerDuplicateScheme(
_In_opt_ HKEY RootPowerKey,
_In_ const GUID *SourceSchemeGuid,
_In_ GUID **DestinationSchemeGuid
);
Parameters
- RootPowerKey [in, optional]
-
This parameter is reserved for future use and must be set to NULL.
- SourceSchemeGuid [in]
-
The identifier of the power scheme that is to be duplicated.
- DestinationSchemeGuid [in]
-
The address of 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.
| Return code/value | Description |
|---|---|
|
The power scheme was successfully duplicated. |
|
One of the parameters is not valid. |
|
The DestinationSchemeGuid parameter refers to an existing power scheme. PowerDeleteScheme can be used to delete this scheme. |
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also