PowerWriteIconResourceSpecifier function (powrprof.h)
Sets the icon resource for the specified power setting, subgroup, or scheme.
Syntax
DWORD PowerWriteIconResourceSpecifier(
[in, optional] HKEY RootPowerKey,
[in] const GUID *SchemeGuid,
[in, optional] const GUID *SubGroupOfPowerSettingsGuid,
[in, optional] const GUID *PowerSettingGuid,
[in] UCHAR *Buffer,
[in] DWORD BufferSize
);
Parameters
[in, optional] RootPowerKey
This parameter is reserved for future use and must be set to NULL.
[in] SchemeGuid
The identifier of the power scheme.
[in, optional] SubGroupOfPowerSettingsGuid
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.
[in, optional] PowerSettingGuid
The identifier of the power setting.
[in] Buffer
The icon resource.
[in] BufferSize
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
If the SchemeGuid parameter is not NULL but both the SubGroupOfPowerSettingsGuid and PowerSettingGuid parameters are NULL, the friendly name of the power scheme will be set. If the SchemeGuid and SubGroupOfPowerSettingsGuid parameters are not NULL and the PowerSettingGuid parameter is NULL, the friendly name of the subgroup will be set. If the SchemeGuid, SubGroupOfPowerSettingsGuid, and PowerSettingGuid parameters are not NULL, the friendly name of the power setting will be set.
Changes to the settings for the active power scheme do not take effect until you call the PowerSetActiveScheme function.
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 |