Share via

SYSTEM_POWER_STATUS_EX

  • Article

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

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

Smartphone Platforms: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: rapi.h
Library: rapi.lib

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.