Windows Mobile 6.5
A version of this page is also available for

This function retrieves battery status information.

DWORD GetSystemPowerStatusEx2(
  PSYSTEM_POWER_STATUS_EX2 pSystemPowerStatusEx2,
  DWORD dwLen, 
  BOOL fUpdate


[out] Pointer to a buffer that receives power status information.


[in] Length of the buffer pointed to by pSystemPowerStatusEx2. To return additional battery information, such as information about an extra battery, provide a data buffer larger than SYSTEM_POWER_STATUS_EX2. Any extra information must be added after the BatteryChemistry member of the SYSTEM_POWER_STATUS_EX2 structure. There must be support for this implemented in the battery driver, and the implementation of this support varies depending on the hardware platform.

In addition, the additional information might be different from platfrom to platform.


[in] Specify TRUE to get the latest information from the device driver. Specify FALSE to get cached information that may be out-of-date by several seconds.

Length of the data returned in the pSystemPowerStatusEx2 buffer indicates success. Zero indicates failure.

Windows Embedded CEWindows CE 2.12 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions