Funzione ReadPwrScheme (powrprof.h)

Articolo
03/01/2024

[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