This function changes the size or the attributes of a specified local memory object. The size can increase or decrease.
At a Glance
| Header file: | Winbase.h |
| Windows CE versions: | 1.0 and later |
Syntax
HLOCAL LocalReAlloc(HLOCAL hMem, UINT uBytes, UINT uFlag);
Parameters
hMem
[in] Handle to the local memory object to be reallocated. This handle is returned by either the LocalAlloc or LocalReAlloc function.
uBytes
[in] New size, in bytes, of the memory block. If uFlags specifies the LMEM_MODIFY flag, this parameter is ignored.
uFlags
[in] Flag that specifies how to reallocate the local memory object. If the LMEM_MODIFY flag is specified, this parameter modifies the attributes of the memory object, and the uBytes parameter is ignored. Otherwise, this parameter controls the reallocation of the memory object.
The LMEM_MODIFY flag can be combined with the following flag:
| Value | Description |
| LMEM_MOVEABLE | You cannot combine LMEM_MOVEABLE with LMEM_MODIFY to change a fixed memory object into a movable one. If you do so, the function returns an error. |
If this parameter does not specify LMEM_MODIFY, this parameter can be any combination of the following flags:
| Value | Description |
| LMEM_MOVEABLE | In Windows CE, this flag enables the memory allocation to move if it can not be allocated in place. |
| LMEM_ZEROINIT | Causes the additional memory contents to be initialized to zero if the memory object is growing in size. |
Return Values
A handle to the reallocated memory object indicates success. NULL indicates failure. To get extended error information, call GetLastError.
Remarks
If LocalReAlloc fails, the original memory is not freed, and the original handle and pointer are still valid.
If LocalReAlloc reallocates a movable object, the return value is a handle to the memory object.
If LocalReAlloc reallocates a fixed object, the value of the handle returned is the address of the first byte of the memory block. To access the memory, a process can simply cast the return value to a pointer.
See Also