Función ReadPwrScheme (powrprof.h)
[ReadPwrScheme está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. Vea comentarios.]
Recupera la configuración de la directiva de energía que es única para el esquema de energía especificado.
Sintaxis
BOOLEAN ReadPwrScheme(
[in] UINT uiID,
[out] PPOWER_POLICY pPowerPolicy
);
Parámetros
[in] uiID
Índice del esquema de energía que se va a leer.
[out] pPowerPolicy
Puntero a una estructura de POWER_POLICY que recibe la configuración de la directiva de energía.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Si el esquema de energía especificado no existe, la función devuelve FALSE.
Para recuperar información sobre la configuración de la directiva de energía que está usando actualmente el sistema, llame a la función GetActivePwrScheme . Para recuperar información adicional sobre la configuración actual de la directiva de energía, llame a la función CallNtPowerInformation .
A partir de Windows Vista, use la función PowerEnumerate para enumerar la configuración de energía de un esquema especificado y las funciones de lectura de energía para recuperar una configuración individual.
Para obtener más información sobre el uso de PowrProf.h, consulte Esquemas de energía.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | powrprof.h |
| Library | PowrProf.lib |
| Archivo DLL | PowrProf.dll |