SetSystemMemoryDivision

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This function sets the specified number of pages for the object store.

Note

This function is deprecated and should no longer be used.

Syntax

DWORD SetSystemMemoryDivision(
  DWORD dwStorePages
);

Parameters

  • dwStorePages
    [in] Specifies the number of pages to allocate for the store.

Return Value

SYSMEM_CHANGED indicates success.

If the memory division cannot be changed until a reboot, SYSMEM_MUSTREBOOT is returned. The function returns SYSMEM_FAILED if the dwStorePages parameter is out of range. If SYSMEM_FAILED is returned, call GetLastError to get extended error information.

Remarks

You cannot shrink system memory or the object store memory to be less than 128 KB each, including space for existing files and records.

It is possible to set the division between storage memory and program memory in the following ways:

If a reboot is necessary for the change to take effect, the function returns SYSMEM_MUSTREBOOT. If a previous call returned SYSMEM_MUSTREBOOT, the function returns SYSMEM_REBOOTPENDING. In this situation, the boundary cannot be adjusted further until the reboot occurs.

Requirements

Header pwindbas.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

Kernel Functions
GetSystemMemoryDivision

Other Resources

FSRAMPERCENT
pOEMCalcFSPages
Configuring Object Store Memory
Privileged APIs