Condividi tramite


Funzione ReadPwrScheme (powrprof.h)

[ReadPwrScheme è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Vedere la sezione Osservazioni.]

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

Sintassi

BOOLEAN ReadPwrScheme(
  [in]  UINT          uiID,
  [out] PPOWER_POLICY pPowerPolicy
);

Parametri

[in] uiID

Indice dello schema di alimentazione da leggere.

[out] pPowerPolicy

Puntatore a una struttura POWER_POLICY che riceve le impostazioni dei criteri di risparmio energia.

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

Se lo schema di alimentazione specificato non esiste, la funzione restituisce FALSE.

Per recuperare informazioni sulle impostazioni dei criteri di risparmio energia attualmente in uso dal sistema, chiamare la funzione GetActivePwrScheme . Per recuperare informazioni aggiuntive sulle impostazioni correnti dei criteri di risparmio energia, chiamare la funzione CallNtPowerInformation .

A partire da Windows Vista, usare la funzione PowerEnumerate per enumerare le impostazioni di risparmio energia per uno schema specificato e le funzioni di lettura alimentazione per recuperare singole impostazioni.

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

Vedi anche

GetActivePwrScheme

POWER_POLICY

Funzioni di risparmio energia

Combinazioni di alimentazione

WritePwrScheme