CeGetSystemPowerStatusEx (RAPI)

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. The RAPI version is CeGetSystemPowerStatusEx for versions 2.0 and later.

BOOL CeGetSystemPowerStatusEx(
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, CeGetSystemPowerStatusEx gets the latest information from the device driver, otherwise it retrieves cached information that may be out-of-date by several seconds.

Return Values

This function returns TRUE if successful; otherwise, it returns FALSE.

Remarks

The CeGetSystemPowerStatusEx function is not supported for emulation.

When working with RAPI for Windows CE versions 1.0 and 1.01, use the PegGetSystemPowerStatusEx function.

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.0 and later Rapi.h    

See Also

SYSTEM_POWER_STATUS_EX

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.