PowerWriteFriendlyName 函数 (powrprof.h)

设置指定电源设置、子组或方案的友好名称。 如果 SchemeGuid 参数不为 NULL ,但 SubGroupOfPowerSettingsGuidPowerSettingGuid 参数均为 NULL,则将设置电源方案的友好名称。 如果 SchemeGuidSubGroupOfPowerSettingsGuid 参数不是 NULLPowerSettingGuid 参数为 NULL,则将设置子组的友好名称。 如果 SchemeGuidSubGroupOfPowerSettingsGuidPowerSettingGuid 参数不是 NULL,则将设置电源设置的友好名称。

语法

DWORD PowerWriteFriendlyName(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SchemeGuid,
  [in, optional] const GUID *SubGroupOfPowerSettingsGuid,
  [in, optional] const GUID *PowerSettingGuid,
  [in]           UCHAR      *Buffer,
  [in]           DWORD      BufferSize
);

参数

[in, optional] RootPowerKey

此参数保留供将来使用,必须设置为 NULL

[in] SchemeGuid

电源方案的标识符。

[in, optional] SubGroupOfPowerSettingsGuid

电源设置的子组。 此参数可以是 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, optional] PowerSettingGuid

电源设置的标识符。

[in] Buffer

友好名称(宽 (Unicode) 个字符)。

[in] BufferSize

Buffer 参数指定的友好名称的大小,包括终止 NULL 字符。

返回值

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

注解

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

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 powrprof.h
Library PowrProf.lib
DLL PowrProf.dll

另请参阅

电源管理功能