Função ReadPwrScheme (powrprof.h)

Artigo
03/01/2024

[ReadPwrScheme 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 de política de energia exclusivas para o esquema de energia especificado.

Sintaxe

BOOLEAN ReadPwrScheme(
  [in]  UINT          uiID,
  [out] PPOWER_POLICY pPowerPolicy
);

Parâmetros

[in] uiID

O índice do esquema de energia a ser lido.

[out] pPowerPolicy

Um ponteiro para uma estrutura POWER_POLICY que recebe as configurações de política de energia.

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

Se o esquema de energia especificado não existir, a função retornará FALSE.

Para recuperar informações sobre as configurações de política de energia atualmente em uso pelo sistema, chame a função GetActivePwrScheme . Para recuperar informações adicionais sobre as configurações atuais da política de energia, chame a função CallNtPowerInformation .

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