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 |