SetSystemMemoryDivision (Compact 2013)

  • Article

3/28/2014

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

Note

This function is obsolete.

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

See Also

Reference

Kernel Functions
GetSystemMemoryDivision

Other Resources

FSRAMPERCENT
OEMCalcFSPages