Share via


A version of this page is also available for

Windows Embedded CE 6.0 R3


This function retrieves battery status information.


DWORD GetSystemPowerStatusEx2(
  PSYSTEM_POWER_STATUS_EX2 pSystemPowerStatusEx2,
  DWORD dwLen, 
  BOOL fUpdate


  • pSystemPowerStatusEx2
    [out] Pointer to a buffer that receives power status information.
  • dwLen
    [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.

  • fUpdate
    [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.

Return Value

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


Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also


System Information Functions