powerDuplicateScheme 函式 (powrprof.h)

  • 發行項

複製現有的電源配置。

語法

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

參數

[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
程式庫 PowrProf.lib
Dll PowrProf.dll

另請參閱

電源管理功能