PowerDuplicateScheme 函数 (powrprof.h)

复制现有电源方案。

语法

DWORD PowerDuplicateScheme(
  [in, optional] HKEY       RootPowerKey,
  [in]           const GUID *SourceSchemeGuid,
  [in]           GUID       **DestinationSchemeGuid
);

parameters

[in, optional] RootPowerKey

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

[in] SourceSchemeGuid

要复制的电源方案的标识符。

[in] DestinationSchemeGuid

指向 GUID 的指针的地址。 如果指针包含 NULL,则该函数会为新的 GUID 分配内存,并将此内存的地址放入指针中。 调用方可以使用 LocalFree 释放此内存。

返回值

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

返回代码/值 说明
ERROR_SUCCESS
0 (0x0)
已成功复制电源方案。
ERROR_INVALID_PARAMETER
87 (0x57)
其中一个参数无效。
ERROR_ALREADY_EXISTS
183 (0xB7)
DestinationSchemeGuid 参数引用现有的电源方案。 PowerDeleteScheme 可用于删除此方案。

要求

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

请参阅

电源管理功能