Función WritePwrScheme (powrprof.h)

Artículo
03/01/2024

[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