GetSystemPowerStatusEx
A version of this page is also available for
4/8/2010
This function retrieves the power status of the system. The status indicates whether the system is running on AC or DC power, whether or not the batteries are currently charging, and the remaining life of main and backup batteries.
A remote application interface (RAPI) version of this function exists, and it is called CeGetSystemPowerStatusEx (RAPI).
Syntax
BOOL GetSystemPowerStatusEx(
PSYSTEM_POWER_STATUS_EX pstatus,
BOOL fUpdate
);
Parameters
- pstatus
[out] Pointer to the SYSTEM_POWER_STATUS_EX structure receiving the power status information.
- fUpdate
[in] If this Boolean is set to TRUE, GetSystemPowerStatusEx gets the latest information from the device driver, otherwise it retrieves cached information that may be out-of-date by several seconds.
Return Value
This function returns TRUE if successful; otherwise, it returns FALSE.
Remarks
The GetSystemPowerStatusEx function is not supported for emulation.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
SYSTEM_POWER_STATUS_EX
System Information Functions