Función ReadGlobalPwrPolicy (powrprof.h)

[ReadGlobalPwrPolicy 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. Ver comentarios.]

Recupera la configuración actual de la directiva de energía global.

Sintaxis

BOOLEAN ReadGlobalPwrPolicy(
  [out] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);

Parámetros

[out] pGlobalPowerPolicy

Puntero a una estructura GLOBAL_POWER_POLICY que recibe la información.

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

La estructura de GLOBAL_POWER_POLICY contiene configuraciones de directiva que son comunes a todos los esquemas de energía. Esta estructura contiene la configuración de directiva de usuario y equipo.

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 configuraciones individuales.

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

Consulte también

GLOBAL_POWER_POLICY

Funciones de administración de energía

WriteGlobalPwrPolicy