GLOBAL_USER_POWER_POLICY structure (powrprof.h)

Contains global user power policy settings that apply to all power schemes for a user. This structure is part of the GLOBAL_POWER_POLICY structure.

Syntax

typedef struct _GLOBAL_USER_POWER_POLICY {
  ULONG               Revision;
  POWER_ACTION_POLICY PowerButtonAc;
  POWER_ACTION_POLICY PowerButtonDc;
  POWER_ACTION_POLICY SleepButtonAc;
  POWER_ACTION_POLICY SleepButtonDc;
  POWER_ACTION_POLICY LidCloseAc;
  POWER_ACTION_POLICY LidCloseDc;
  SYSTEM_POWER_LEVEL  DischargePolicy[NUM_DISCHARGE_POLICIES];
  ULONG               GlobalFlags;
} GLOBAL_USER_POWER_POLICY, *PGLOBAL_USER_POWER_POLICY;

Members

Revision

The current structure revision level. Set this value by calling GetCurrentPowerPolicies or ReadGlobalPwrPolicy before using a GLOBAL_USER_POWER_POLICY structure to set power policy.

PowerButtonAc

A POWER_ACTION_POLICY structure that defines the action to take when the power button is pressed and the system is running on AC power.

PowerButtonDc

A POWER_ACTION_POLICY structure that defines the action to take when the power button is pressed and the system is running on battery power.

SleepButtonAc

A POWER_ACTION_POLICY structure that defines the action to take when the sleep button is pressed and the system is running on AC power.

SleepButtonDc

A POWER_ACTION_POLICY structure that defines the action to take when the sleep button is pressed and the system is running on battery power.

LidCloseAc

A POWER_ACTION_POLICY structure that defines the action to take when the lid is closed and the system is running on AC power.

LidCloseDc

A POWER_ACTION_POLICY structure that defines the action to take when the lid is closed and the system is running on battery power.

DischargePolicy[NUM_DISCHARGE_POLICIES]

An array of SYSTEM_POWER_LEVEL structures that defines the actions to take at system battery discharge events.

GlobalFlags

A flag that enables or disables miscellaneous user power policy settings. This member can be one or more of the values described in Global Flags Constants.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header powrprof.h

See also

GLOBAL_POWER_POLICY

POWER_ACTION_POLICY

SYSTEM_POWER_LEVEL