Share via


SetSystemMemoryDivision (Windows CE 5.0)

Send Feedback

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

Note   This function is deprecated and should no longer be used.

DWORDSetSystemMemoryDivision( DWORD dwStorePages );

Parameters

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

Return Values

The function returns SYSMEM_CHANGED if it is executed successfully. 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, you can get further information by calling GetLastError.

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 two 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.

Windows Mobile Remarks

For Windows Mobile 5.0, this function will always fail.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Pwindbas.h.
Link Library: Coredll.lib.

See Also

FSRAMPERCENT| pOEMCalcFSPages | GetSystemMemoryDivision | Configuring Object Store Memory | Trusted APIs

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.