Função WritePwrScheme (powrprof.h)

Artigo
03/05/2024

[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