Compartilhar via


Função PowerDuplicateScheme (powrprof.h)

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 de retorno

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

Código/valor de retorno Description
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.

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header powrprof.h
Library PowrProf.lib
de DLL PowrProf.dll

Consulte também

Funções de gerenciamento de energia