Función SetActivePwrScheme (powrprof.h)
[SetActivePwrScheme 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. Las aplicaciones escritas para Windows Vista y versiones posteriores deben usar PowerSetActiveScheme en su lugar.
Establece el esquema de energía activo.
Sintaxis
BOOLEAN SetActivePwrScheme(
[in] UINT uiID,
[in, optional] PGLOBAL_POWER_POLICY pGlobalPowerPolicy,
[in, optional] PPOWER_POLICY pPowerPolicy
);
Parámetros
[in] uiID
Índice del esquema de energía que se va a activar.
[in, optional] pGlobalPowerPolicy
Puntero a una estructura de GLOBAL_POWER_POLICY opcional, que proporciona la configuración de directiva de energía global que se va a combinar con el esquema de energía cuando se activa.
[in, optional] pPowerPolicy
Puntero a una estructura de POWER_POLICY opcional, que proporciona la configuración de directiva de energía que se va a combinar con el esquema de energía cuando se activa.
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
Use esta función para realizar cambios a largo plazo en la configuración del sistema. Para mantener temporalmente el sistema en ejecución mientras una aplicación realiza una tarea, use la función SetThreadExecutionState .
Si el esquema de energía especificado por uiID no existe, la función devuelve cero.
Si lpGlobalPowerPolicy es NULL, la función usa la configuración actual de la directiva de energía global establecida por WriteGlobalPwrPolicy. De lo contrario, la configuración de la estructura especificada reemplaza la configuración actual de la directiva de energía global.
Si lpPowerPolicy es NULL, la función usa la configuración de directiva de energía actual para el esquema de energía. De lo contrario, la configuración de la estructura especificada reemplaza la configuración actual de la directiva de energía.
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 |