This topic has not yet been rated - Rate this topic

PowerWriteSettingAttributes function

Applies to: desktop apps only

Sets the power attributes of a power key. If the PowerSettingGuid parameter is NULL then the attribute for SubGroupGuid is set, otherwise the attribute for PowerSettingGuid is set.

Syntax

Copy

DWORD WINAPI PowerWriteSettingAttributes(
  __in  const GUID *SubGroupGuid,
  __in  const GUID *PowerSettingGuid,
  __in  DWORD Attributes
);

Parameters

SubGroupGuid [in]

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.

Value	Meaning
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	Settings in this subgroup are part of the default power scheme.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	Settings in this subgroup control power management configuration of the system's hard disk drives.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Settings in this subgroup control configuration of the system power buttons.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	Settings in this subgroup control configuration of processor power management features.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Settings in this subgroup control configuration of the video power management features.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	Settings in this subgroup control battery alarm trip points and actions.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	Settings in this subgroup control system sleep settings.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	Settings in this subgroup control PCI Express settings.

PowerSettingGuid [in]

The identifier of the power setting.

Attributes [in]

The attributes to be associated with the specified power setting.

Value	Meaning
POWER_ATTRIBUTE_HIDE 1	Hide this power setting.

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