ITCPowerStatus
Returns the AC line status, main battery status, backup battery status, and remaining percentage of battery life.
Syntax
HRESULT ITCPowerStatus (
LPDWORD lpdwLineStatus,
LPDWORD lpdwBatteryStatus,
LPDWORD lpdwBackupStatus,
UINT *puFuelGauge
);
Parameters
lpdwLineStatus
[out] Returns the AC line status:
- ITC_ACLINE_NOT_CONNECTED: AC line is not connected.
- ITC_ACLINE_CONNECTED: AC line is connected.
- ITC_UNKNOWN_ACLINE: AC line status is unknown.
lpdwBatteryStatus
[out] Returns the main battery status:
- ITC_HIGH_BAT: Battery charge is high.
- ITC_LOW_BAT: Battery charge is low.
- ITC_CRITICAL_BAT: Battery charge is critical.
- ITC_CHARGING_BAT: Battery is charging now.
- ITC_NO_SYSTEM_BAT: No system battery.
- ITC_UNKNOWN_BAT: Battery condition is unknown.
lpdwBackupStatus
[out] Returns the bridge battery status:
- ITC_HIGH_BACKUP: Backup battery is high.
- ITC_LOW_BACKUP: Backup battery is low.
- ITC_CRITICAL_BACKUP: Backup battery is critical.
- ITC_CHARGING_BACKUP: Backup battery is charging now.
- ITC_NO_SYSTEM_BACKUP: No system backup battery.
- ITC_UNKNOWN_BACKUP: Backup battery condition is unknown.
puFuelGauge
[out] Returns percentage of remaining battery life:
- 0 to 100: Percentage of battery charge.
- 255: Battery life is unknown.
Return Values
ITC_SUCCESS
Success.
ITC_FAIL
Fail.
ITC_ERROR_FUNCTION_NOT_SUPPORTED
The function was called on a platform that does not support this feature.
Remarks
The Windows CE Win32 API provides a similar API function with GetSystemPowerStatusEx.
Header and Library Files
Header File: ITC50.H
Library: ITC50.LIB
More Information
Computer State Functions