writePwrScheme 函数 (powrprof.h)

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

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

语法

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

parameters

[in] puiID

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

[in] lpszSchemeName

电源方案的名称。

[in, optional] lpszDescription

电源方案的说明。

[in] lpScheme

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

返回值

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

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

注解

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

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

有关使用 PowrProf.h 的详细信息,请参阅 Power Schemes

要求

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

请参阅

DeletePwrScheme

POWER_POLICY

电源管理功能

电源方案

ReadPwrScheme

SetActivePwrScheme