Funzione WritePwrScheme (powrprof.h)

Articolo
03/01/2024

[WritePwrScheme non è più disponibile per l'uso a partire da Windows Vista. Usare invece la funzione PowerEnumerate per enumerare le impostazioni di risparmio energia per uno schema specificato e le funzioni di scrittura alimentazione per scrivere singole impostazioni.

Scrive le impostazioni dei criteri univoche per lo schema di risparmio energia specificato.

Sintassi

BOOLEAN WritePwrScheme(
  [in]           PUINT         puiID,
  [in]           LPCWSTR       lpszSchemeName,
  [in, optional] LPCWSTR       lpszDescription,
  [in]           PPOWER_POLICY lpScheme
);

Parametri

[in] puiID

Indice dello schema di alimentazione da scrivere. Se esiste già uno schema di alimentazione con lo stesso indice, viene sostituito. In caso contrario, viene creato un nuovo schema di alimentazione.

[in] lpszSchemeName

Nome dello schema di alimentazione.

[in, optional] lpszDescription

Descrizione dello schema di alimentazione.

[in] lpScheme

Puntatore a una struttura POWER_POLICY che contiene le impostazioni dei criteri di risparmio energia da scrivere.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa modifica non influisce sui criteri di risparmio energia di sistema correnti. Per applicare questa modifica ai criteri di risparmio energia di sistema correnti, chiamare la funzione SetActivePwrScheme con l'indice di questo schema di alimentazione.

Gli schemi di criteri di risparmio energia scritti con WritePwrScheme vengono archiviati in modo permanente negli hive del Registro di sistema e rimangono disponibili per l'uso nel programma del Pannello di controllo opzioni di Power o tramite chiamate successive all'API di risparmio energia. Per rimuovere definitivamente uno schema di alimentazione dal sistema, chiamare la funzione DeletePwrScheme .

Per altre informazioni sull'uso di PowrProf.h, vedere Combinazioni di alimentazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	powrprof.h
Libreria	PowrProf.lib
DLL	PowrProf.dll