BatteryDrvrGetStatus

This function returns the status of the main and backup batteries.

Syntax

BOOL BatteryDrvrGetStatus( PBATTERY_STATUS pBatteryStatus );

Parameters

pBatteryStatus
Pointer to the BATTERY_STATUS structure that contains the battery status.

Return Values

TRUE indicates that the function successfully obtained the battery status. FALSE indicates that the function failed to obtain the battery status.

Remarks

The following table shows the values that are presently returned for members of the BATTERY_STATUS structure.

Member
Value
ACLineStatus AC_LINE_UNKNOWN
BatteryFlag BATTERY_FLAG_HIGH or BATTERY_FLAG_NO_BATTERY
BatteryLifePercent BATTERY_PERCENTAGE_UNKNOWN
BatteryLifeTime BATTERY_LIFE_UNKNOWN
BatteryFullLifeTime BATTERY_LIFE_UNKNOWN