Compartilhar via


Função GetActivePwrScheme (powrprof.h)

[GetActivePwrScheme está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Os aplicativos gravados para o Windows Vista e posteriores devem usar o PowerGetActiveScheme em vez disso.]

Recupera o índice do esquema de energia ativo.

Sintaxe

BOOLEAN GetActivePwrScheme(
  [out] PUINT puiID
);

Parâmetros

[out] puiID

Um ponteiro para uma variável que recebe o índice do esquema de energia ativo.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

O esquema de energia ativo permanece ativo até que o usuário defina um novo esquema de energia usando o programa do painel de controle do Power Options ou um aplicativo chame a função SetActivePwrScheme .

Para obter mais informações sobre como usar PowrProf.h, consulte Esquemas de energia.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [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

Esquemas de energia

SetActivePwrScheme