Compartilhar via


Função ReadGlobalPwrPolicy (powrprof.h)

[ReadGlobalPwrPolicy 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. Consulte Comentários.]

Recupera as configurações atuais da política de energia global.

Sintaxe

BOOLEAN ReadGlobalPwrPolicy(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

Parâmetros

[out] pGlobalPowerPolicy

Um ponteiro para uma estrutura GLOBAL_POWER_POLICY que recebe as informações.

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

A estrutura GLOBAL_POWER_POLICY contém configurações de política comuns a todos os esquemas de energia. Essa estrutura contém as configurações de política do usuário e do computador.

A partir do Windows Vista, use a função PowerEnumerate para enumerar as configurações de energia para um esquema especificado e as funções de leitura de energia para recuperar configurações individuais.

Para obter mais informações sobre como usar PowrProf.h, consulte Power Schemes.

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

GLOBAL_POWER_POLICY

Funções de gerenciamento de energia

WriteGlobalPwrPolicy