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
| 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 |