Función ReadPwrScheme (powrprof.h)

Artículo
03/05/2024

[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