writePwrScheme 函数 (powrprof.h)

[WritePwrScheme 在 Windows Vista 中不再可用。 相反,使用 PowerEnumerate 函数枚举指定方案的电源设置,并使用电源写入函数来编写单个设置。]

写入对指定电源方案唯一的策略设置。

语法

BOOLEAN WritePwrScheme(
  [in]           PUINT         puiID,
  [in]           LPCWSTR       lpszSchemeName,
  [in, optional] LPCWSTR       lpszDescription,
  [in]           PPOWER_POLICY lpScheme
);

参数

[in] puiID

要写入的电源方案的索引。 如果已存在具有相同索引的电源方案,则将其替换。 否则,将创建新的电源方案。

[in] lpszSchemeName

电源方案的名称。

[in, optional] lpszDescription

电源方案的说明。

[in] lpScheme

指向包含要写入的电源策略设置的 POWER_POLICY 结构的指针。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

此更改不会影响当前系统电源策略。 若要将此更改应用于当前系统电源策略,请使用此电源方案的索引调用 SetActivePwrScheme 函数。

使用 WritePwrScheme 编写的电源策略方案永久存储在系统注册表配置单元中,并且仍可在电源选项控制面板程序中使用,也可以通过后续调用电源方案 API 来使用。 若要从系统永久删除电源方案,请调用 DeletePwrScheme 函数。

有关使用 PowrProf.h 的详细信息,请参阅 电源方案

要求

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

另请参阅

DeletePwrScheme

POWER_POLICY

电源管理功能

电源方案

ReadPwrScheme

SetActivePwrScheme