SYSTEM_POWER_STATUS_EX (RAPI)

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

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