Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function gets information on the physical and virtual memory of the system on a remote Windows Embedded CE–based device.

Syntax 

void CeGlobalMemoryStatus(
  LPMEMORYSTATUS 
lpmst
);

Parameters

lpmst

[out] Pointer to a MEMORYSTATUSstructure in which information about current memory availability is stored.

Return Value

None.

Note:
This function generates a RAPI level error if it cannot properly marshal parameters between the Windows Embedded CE-based device and the desktop computer. In this case, you can trace the error by calling the CeRapiGetError (RAPI)function.

Remarks

You can use the CeGlobalMemoryStatusfunction to determine how much memory your application can allocate without severely impacting other applications.

The information returned by the CeGlobalMemoryStatusfunction is volatile. There is no guarantee that two sequential calls to this function will get the same information.

Requirements

Header rapi.h
Library rapi.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

RAPI Functions