Edit

Share via

ADMINISTRATOR_POWER_POLICY structure (winnt.h)

  • Article

Represents the administrator override power policy settings.

Syntax

typedef struct _ADMINISTRATOR_POWER_POLICY {
  SYSTEM_POWER_STATE MinSleep;
  SYSTEM_POWER_STATE MaxSleep;
  DWORD              MinVideoTimeout;
  DWORD              MaxVideoTimeout;
  DWORD              MinSpindownTimeout;
  DWORD              MaxSpindownTimeout;
} ADMINISTRATOR_POWER_POLICY, *PADMINISTRATOR_POWER_POLICY;

Members

MinSleep

The minimum system power sleep state. This member must be one of the SYSTEM_POWER_STATE enumeration type values between PowerSystemSleeping1 (power state S1) and PowerSystemHibernate (power state S4).

MaxSleep

The maximum system power sleep state. This member must be one of the SYSTEM_POWER_STATE enumeration type values between PowerSystemSleeping1 (power state S1) and PowerSystemHibernate (power state S4).

MinVideoTimeout

The minimum allowable video idle time-out before turning the display device off, in seconds.

MaxVideoTimeout

The maximum allowable video idle time-out before turning the display device off, in seconds.

MinSpindownTimeout

The minimum allowable disk idle time before flushing the cache manager and spinning down a hard disk device, in seconds.

MaxSpindownTimeout

The maximum allowable disk idle time before flushing the cache manager and spinning down a hard disk device, in seconds.

Remarks

The ADMINISTRATOR_POWER_POLICY structure defines limits to certain power policy values that are applied globally to all users' power schemes. The values in the ADMINISTRATOR_POWER_POLICY structure override any settings selected by the user in the Power Options control panel program.

To set an administrator override policy, call the CallNtPowerInformation function.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header winnt.h (include Windows.h)

See also

CallNtPowerInformation