Função PowerDuplicateScheme (powrprof.h)

Artigo
08/25/2023

Duplica um esquema de energia existente.

Sintaxe

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

Parâmetros

[in, optional] RootPowerKey

Esse parâmetro é reservado para uso futuro e deve ser definido como NULL.

[in] SourceSchemeGuid

O identificador do esquema de energia que deve ser duplicado.

[in] DestinationSchemeGuid

O endereço de um ponteiro para um GUID. Se o ponteiro contiver NULL, a função alocará memória para um novo GUID e colocará o endereço dessa memória no ponteiro. O chamador pode liberar essa memória usando LocalFree.

Valor retornado

Retornará ERROR_SUCCESS (zero) se a chamada tiver sido bem-sucedida e um valor diferente de zero se a chamada falhar.

Valor/código retornado	Descrição
ERROR_SUCCESS 0 (0x0)	O esquema de energia foi duplicado com êxito.
ERROR_INVALID_PARAMETER 87 (0x57)	Um dos parâmetros não é válido.
ERROR_ALREADY_EXISTS 183 (0xB7)	O parâmetro DestinationSchemeGuid refere-se a um esquema de energia existente. O PowerDeleteScheme pode ser usado para excluir esse esquema.

Requisitos


Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	powrprof.h
Biblioteca	PowrProf.lib
DLL	PowrProf.dll

Confira também

Funções de gerenciamento de energia

Compartilhar via