Função WriteGlobalPwrPolicy (powrprof.h)
[WriteGlobalPwrPolicy 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.]
Grava as configurações de política de energia global.
Sintaxe
BOOLEAN WriteGlobalPwrPolicy(
[in] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);
Parâmetros
[in] pGlobalPowerPolicy
Um ponteiro para uma estrutura GLOBAL_POWER_POLICY que contém as configurações de política de energia a serem gravadas.
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 função substitui todas as configurações de política de energia globais existentes. Cada usuário tem um esquema de energia global separado, que contém configurações de política de energia que se aplicam a todos os esquemas de energia para esse usuário.
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 gravação de energia para gravar 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 |