Función WriteGlobalPwrPolicy (powrprof.h)
[WriteGlobalPwrPolicy 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.]
Escribe la configuración de la directiva de energía global.
Sintaxis
BOOLEAN WriteGlobalPwrPolicy(
[in] PGLOBAL_POWER_POLICY pGlobalPowerPolicy
);
Parámetros
[in] pGlobalPowerPolicy
Puntero a una estructura de GLOBAL_POWER_POLICY que contiene la configuración de la directiva de energía que se va a escribir.
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 función reemplaza cualquier configuración de directiva de energía global existente. Cada usuario tiene un esquema de energía global independiente, que contiene la configuración de la directiva de energía que se aplica a todos los esquemas de energía para ese usuario.
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 escritura de energía para escribir 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 |