Функция PowerDuplicateScheme (powrprof.h)

Статья
08/25/2023

Дублирует существующую схему питания.

Синтаксис

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
Header	powrprof.h
Библиотека	PowrProf.lib
DLL	PowrProf.dll

См. также раздел

Функции управления питанием

Поделиться через