Función PowerReadSettingAttributes (powrprof.h)

Devuelve el atributo actual de la configuración de energía especificada. Si el parámetro SubGroupGuid es NULL , se devuelve el atributo para PowerSettingGuid . Si el parámetro PowerSettingGuid es NULL , se devuelve el atributo para SubGroupGuid . Si los parámetros SubGroupGuid y PowerSettingGuid son válidos, el valor devuelto es la combinación (OR bit a bit) de los atributos del subgrupo y la configuración de energía.

Sintaxis

DWORD PowerReadSettingAttributes(
  [in] const GUID *SubGroupGuid,
  [in] const GUID *PowerSettingGuid
);

Parámetros

[in] SubGroupGuid

Subgrupo de la configuración de energía. Este parámetro puede ser uno de los siguientes valores definidos en WinNT.h. Use NO_SUBGROUP_GUID para hacer referencia al esquema de energía predeterminado.

Estos valores son los valores del subgrupo incluidos con Windows.

Valor	Significado
NO_SUBGROUP_GUID fea3413e-7e05-4911-9a71-700331f1c294	La configuración de este subgrupo forma parte del esquema de energía predeterminado.
GUID_DISK_SUBGROUP 0012ee47-9041-4b5d-9b77-535fba8b1442	La configuración de este subgrupo controla la configuración de administración de energía de las unidades de disco duro del sistema.
GUID_SYSTEM_BUTTON_SUBGROUP 4f971e89-eebd-4455-a8de-9e59040e7347	Configuración de esta configuración de control de subgrupo de los botones de encendido del sistema.
GUID_PROCESSOR_SETTINGS_SUBGROUP 54533251-82be-4824-96c1-47b60b740d00	La configuración de este subgrupo controla la configuración de las características de administración de energía del procesador.
GUID_VIDEO_SUBGROUP 7516b95f-f776-4464-8c53-06167f40cc99	Configuración de esta configuración de control de subgrupo de las características de administración de energía de vídeo.
GUID_BATTERY_SUBGROUP e73a048d-bf27-4f12-9731-8b2076e8891f	La configuración de este subgrupo controla los puntos y acciones de alarma de batería.
GUID_SLEEP_SUBGROUP 238C9FA8-0AAD-41ED-83F4-97BE242C8F20	La configuración de este subgrupo controla la configuración de suspensión del sistema.
GUID_PCIEXPRESS_SETTINGS_SUBGROUP 501a4d13-42af-4429-9fd1-a8218c268e20	La configuración de este subgrupo controla la configuración de PCI Express.

[in] PowerSettingGuid

Identificador de la configuración de energía que se está usando.

Valor devuelto

Devuelve los atributos de configuración de energía actuales de la configuración de energía especificada. El atributo es una combinación de los atributos de la configuración de energía y los atributos de su subgrupo.

Código o valor devuelto	Descripción
POWER_ATTRIBUTE_HIDE 1	Oculte esta configuración de energía.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	powrprof.h
Library	PowrProf.lib
Archivo DLL	PowrProf.dll

Consulte también

Funciones de administración de energía