Funzione SetActivePwrScheme (powrprof.h)

[SetActivePwrScheme è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Le applicazioni scritte per Windows Vista e versioni successive devono usare invece PowerSetActiveScheme .

Imposta lo schema di alimentazione attivo.

Sintassi

BOOLEAN SetActivePwrScheme(
  [in]           UINT                 uiID,
  [in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
  [in, optional] PPOWER_POLICY        pPowerPolicy
);

Parametri

[in] uiID

Indice dello schema di alimentazione da attivare.

[in, optional] pGlobalPowerPolicy

Puntatore a una struttura di GLOBAL_POWER_POLICY facoltativa, che fornisce le impostazioni globali dei criteri di risparmio energia da unire con lo schema di alimentazione quando diventa attivo.

[in, optional] pPowerPolicy

Puntatore a una struttura di POWER_POLICY facoltativa, che fornisce le impostazioni dei criteri di risparmio energia da unire allo schema di alimentazione quando diventa attivo.

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

Usare questa funzione per apportare modifiche a lungo termine alla configurazione del sistema. Per mantenere temporaneamente in esecuzione il sistema durante l'esecuzione di un'applicazione, usare la funzione SetThreadExecutionState .

Se lo schema di alimentazione specificato da uiID non esiste, la funzione restituisce zero.

Se lpGlobalPowerPolicy è NULL, la funzione usa le impostazioni correnti dei criteri di risparmio energia globali impostate da WriteGlobalPwrPolicy. In caso contrario, le impostazioni nella struttura specificata sostituiscono le impostazioni dei criteri di risparmio energia globali correnti.

Se lpPowerPolicy è NULL, la funzione usa le impostazioni correnti dei criteri di risparmio energia per lo schema di alimentazione. In caso contrario, le impostazioni nella struttura specificata sostituiscono le impostazioni correnti dei criteri di risparmio energia.

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

Requisiti

Vedi anche

GLOBAL_POWER_POLICY

GetActivePwrScheme

POWER_POLICY

Funzioni di risparmio energia

Combinazioni di alimentazione