writePwrScheme 函数 (powrprof.h)

项目
03/13/2024

[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