SetSystemMemoryDivision (Windows CE 5.0)
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:
- Statically using FSRAMPERCENT
- During boot using pOEMCalcFSPages
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