GetSystemPowerStatusEx2 (Windows CE 5.0)

Send Feedback

This function retrieves battery status information.

DWORD GetSystemPowerStatusEx2(PSYSTEM_POWER_STATUS_EX2 pSystemPowerStatusEx2,DWORD dwLen, BOOL fUpdate);

Parameters

  • pSystemPowerStatusEx2
    [out] Pointer to a buffer that receives power status information.

  • dwLen
    [in] Length of the buffer pointed to by pSystemPowerStatusEx2. To return additional battery information, such as information about an extra battery, provide a data buffer larger than SYSTEM_POWER_STATUS_EX2. Any extra information must be added after the BatteryChemistry member of the SYSTEM_POWER_STATUS_EX2 structure. There must be support for this implemented in the battery driver, and the implementation of this support varies depending on the hardware platform.

    In addition, the additional information might be different from platfrom to platform.

  • fUpdate
    [in] Specify TRUE to get the latest information from the device driver. Specify FALSE to get cached information that may be out-of-date by several seconds.

Return Values

Length of the data returned in the pSystemPowerStatusEx2 buffer indicates success. Zero indicates failure.

Requirements

OS Versions: Windows CE 2.12 and later.
Header: Winbase.h.
Link Library: Coredll.lib.

See Also

SYSTEM_POWER_STATUS_EX2 | System Information Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.