Função WritePwrScheme (powrprof.h)
[WritePwrScheme não está mais disponível para uso a partir do Windows Vista. Em vez disso, 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.]
Grava configurações de política exclusivas para o esquema de energia especificado.
Sintaxe
BOOLEAN WritePwrScheme(
[in] PUINT puiID,
[in] LPCWSTR lpszSchemeName,
[in, optional] LPCWSTR lpszDescription,
[in] PPOWER_POLICY lpScheme
);
Parâmetros
[in] puiID
O índice do esquema de energia a ser gravado. Se já existir um esquema de energia com o mesmo índice, ele será substituído. Caso contrário, um novo esquema de energia será criado.
[in] lpszSchemeName
O nome do esquema de energia.
[in, optional] lpszDescription
A descrição do esquema de energia.
[in] lpScheme
Um ponteiro para uma estrutura 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
Essa alteração não afeta a política de energia do sistema atual. Para aplicar essa alteração à política de energia do sistema atual, chame a função SetActivePwrScheme com o índice desse esquema de energia.
Os esquemas de política de energia escritos usando WritePwrScheme são armazenados permanentemente nos hives do registro do sistema e permanecem disponíveis para uso no programa do painel de controle do Power Options ou por chamadas subsequentes à API do esquema de energia. Para remover permanentemente um esquema de energia do sistema, chame a função DeletePwrScheme .
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 |