PowerWriteSettingAttributes 函数 (powrprof.h)

设置电源键的电源属性。如果 PowerSettingGuid 参数为 NULL ，则设置 SubGroupGuid 的属性，否则将设置 PowerSettingGuid 的属性 。

语法

DWORD PowerWriteSettingAttributes(
  [in] const GUID *SubGroupGuid,
  [in] const GUID *PowerSettingGuid,
  [in] DWORD      Attributes
);

[in] SubGroupGuid

电源设置的子组。此参数可以是 WinNT.h 中定义的以下值之一。使用 NO_SUBGROUP_GUID 引用默认电源方案。

值	含义
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	此子组中的设置是默认电源方案的一部分。
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	此子组中的设置控制系统硬盘驱动器的电源管理配置。
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	系统电源按钮的此子组控制配置中的设置。
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	此子组控制处理器电源管理功能配置中的设置。
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	视频电源管理功能的此子组控制配置中的设置。
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	此子组中的设置控制电池警报跳闸点和操作。
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	此子组控制系统睡眠设置中的设置。
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	此子组中的设置控制 PCI Express 设置。

[in] PowerSettingGuid

电源设置的标识符。

[in] Attributes

要与指定的电源设置关联的属性。

值	含义
POWER_ATTRIBUTE_HIDE 1	隐藏此电源设置。

如果调用成功，则返回 ERROR_SUCCESS (零) ;如果调用失败，则返回非零值。

在调用 PowerSetActiveScheme 函数之前，对活动电源方案设置的更改不会生效。