CeGetSystemPowerStatusEx (RAPI)

Send Feedback

This function retrieves the power status of the system on a remote Microsoft® Windows® CE–based device. 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.

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

Nonzero indicates success. Zero indicates failure.

Remarks

The CeGetSystemPowerStatusEx function is not supported for emulation.

Requirements

Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: Rapi.h
Library: Rapi.lib

See Also

Remote API Functions | SYSTEM_POWER_STATUS_EX

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.