PowerWritePossibleValue function
Sets the value for a possible value of a power setting.
Syntax
DWORD WINAPI PowerWritePossibleValue( _In_opt_ HKEY RootPowerKey, _In_opt_ const GUID *SubGroupOfPowerSettingsGuid, _In_opt_ const GUID *PowerSettingGuid, _In_ ULONG Type, _In_ ULONG PossibleSettingIndex, _In_ UCHAR *Buffer, _In_ DWORD BufferSize );
Parameters
- RootPowerKey [in, optional]
-
This parameter is reserved for future use and must be set to NULL.
- SubGroupOfPowerSettingsGuid [in, optional]
-
The subgroup of power settings. This parameter can be one of the following values defined in WinNT.h. Use NO_SUBGROUP_GUID to refer to the default power scheme.
- PowerSettingGuid [in, optional]
-
The identifier of the power setting.
- Type [in]
-
The type of data for the value. The possible values are listed in Registry Value Types.
- PossibleSettingIndex [in]
-
The zero-based index for the possible setting.
- Buffer [in]
-
The value for the possible setting.
- BufferSize [in]
-
The size of the buffer pointed to by the Buffer parameter.
Return value
Returns ERROR_SUCCESS (zero) if the call was successful, and a nonzero value if the call failed.
Remarks
Changes to the settings for the active power scheme do not take effect until you call the PowerSetActiveScheme function.
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also