Función WritePwrScheme (powrprof.h)
[WritePwrScheme ya no está disponible para su uso en Windows Vista. En su lugar, 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 una configuración individual.
Escribe la configuración de directiva que es única para el esquema de energía especificado.
Sintaxis
BOOLEAN WritePwrScheme(
[in] PUINT puiID,
[in] LPCWSTR lpszSchemeName,
[in, optional] LPCWSTR lpszDescription,
[in] PPOWER_POLICY lpScheme
);
Parámetros
[in] puiID
Índice del esquema de energía que se va a escribir. Si ya existe un esquema de energía con el mismo índice, se reemplaza. De lo contrario, se crea un nuevo esquema de energía.
[in] lpszSchemeName
Nombre del esquema de energía.
[in, optional] lpszDescription
Descripción del esquema de energía.
[in] lpScheme
Puntero a una estructura de POWER_POLICY que contiene la configuración de 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
Este cambio no afecta a la directiva de energía del sistema actual. Para aplicar este cambio a la directiva de energía del sistema actual, llame a la función SetActivePwrScheme con el índice de este esquema de energía.
Los esquemas de directivas de energía escritos mediante WritePwrScheme se almacenan permanentemente en los subárboles del Registro del sistema y permanecen disponibles para su uso en el programa del panel de control de Power Options o mediante llamadas posteriores a la API del esquema de energía. Para quitar permanentemente un esquema de energía del sistema, llame a la función DeletePwrScheme .
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 |