Función SetActivePwrScheme (powrprof.h)

Artículo
03/08/2023

[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