Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains information about the power status of the system.

Syntax 

typedef struct _SYSTEM_POWER_STATUS_EX {
  BYTE 
ACLineStatus;
  BYTE 
BatteryFlag;
  BYTE 
BatteryLifePercent;
  BYTE 
Reserved1;
  DWORD 
BatteryLifeTime;
  DWORD 
BatteryFullLifeTime;
  BYTE 
Reserved2;
  BYTE 
BackupBatteryFlag;
  BYTE 
BackupBatteryLifePercent;
  BYTE 
Reserved3;
  DWORD 
BackupBatteryLifeTime;
  DWORD 
BackupBatteryFullLifeTime;
} SYSTEM_POWER_STATUS_EX, * PSYSTEM_POWER_STATUS_EX, *
LPSYSTEM_POWER_STATUS_EX;

Members

ACLineStatus

AC power status. It is one of the following values.

Value Description

0

Offline

1

Online

2

Backup power

255

Unknown status

All other values are reserved.

BatteryFlag

Battery charge status. It can be a combination of the following values.

Value Description

1

High

2

Low

4

Critical

8

Charging

128

No system battery

255

Unknown status

All other values are reserved.

BatteryLifePercent

Percentage of full battery charge remaining. This member can be a value in the range 0 to 100, or 255 if status is unknown. All other values are reserved.

Reserved1

Reserved; set to zero.

BatteryLifeTime

Number of seconds of battery life remaining, or 0xFFFFFFFF if remaining seconds are unknown.

BatteryFullLifeTime

Number of seconds of battery life when at full charge, or 0xFFFFFFFF if full lifetime is unknown.

Reserved2

Reserved; set to zero.

BackupBatteryFlag

Backup battery charge status. It is one of the following values.

Flag

BATTERY_FLAG_HIGH

BATTERY_FLAG_CRITICAL

BATTERY_FLAG_CHARGING

BATTERY_FLAG_NO_BATTERY

BATTERY_FLAG_UNKNOWN

BATTERY_FLAG_LOW
BackupBatteryLifePercent

Percentage of full backup battery charge remaining. Must be in the range 0 to 100, or BATTERY_PERCENTAGE_UNKNOWN.

Reserved3

Reserved; set to zero

BackupBatteryLifeTime

Number of seconds of backup battery life remaining, or BATTERY_LIFE_UNKNOWN if remaining seconds are unknown.

BackupBatteryFullLifeTime

Number of seconds of backup battery life when at full charge, or BATTERY_LIFE_UNKNOWN if full lifetime is unknown.

Requirements

Header rapitypes.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Concepts

RAPI Structures