GetSystemPowerStatusEx2

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves battery status information.

Syntax

DWORD GetSystemPowerStatusEx2(
  PSYSTEM_POWER_STATUS_EX2 pSystemPowerStatusEx2,
  DWORD dwLen, 
  BOOL fUpdate
);

Parameters

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

Requirements

See Also

Reference

SYSTEM_POWER_STATUS_EX2
System Information Functions