GetSystemPowerStatusEx2
A version of this page is also available for
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
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 2.12 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |