Função ReadPwrScheme (powrprof.h)
[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 |