LocalAlloc (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function allocates the specified number of bytes from the heap.

In the linear Microsoft® Windows® CE API environment, there is no difference between the local heap and the global heap.

HLOCAL LocalAlloc(
  UINT uFlags, 
  UINT uBytes 
); 

Parameters

uFlags
[in] Specifies how to allocate memory.

If zero is specified, the default is the LMEM_FIXED flag.

The following table shows the flags for this parameter. The parameter is one of these flags.

ValueDescription
LMEM_FIXEDAllocates fixed memory. The return value is a pointer to the memory object.
LPTRCombines the LMEM_FIXED and LMEM_ZEROINIT flags.
LMEM_ZEROINITInitializes memory contents to zero.
uBytes
[in] Specifies the number of bytes to allocate.

Return Values

A handle to the newly allocated memory object indicates success.

NULL indicates failure.

To get extended error information, call GetLastError.

Remarks

If the heap does not contain sufficient free space to satisfy the request, LocalAlloc returns NULL. Because NULL is used to indicate an error, virtual address zero is never allocated. Therefore, it is easy to detect the use of a NULL pointer.

If this function succeeds, it allocates at least the amount requested. If the amount allocated is greater than the amount requested, the process can use the entire amount.

To determine the number of bytes allocated, use the LocalSize function.

To free the memory, use the LocalFree function.

For Windows CE versions 1.0 and 1.01, the local heap for each process cannot exceed 1 MB. However, a process can create multiple heaps using the HeapCreate function and each heap can be up to 1 MB.

For Windows CE versions 1.0 through 2.12, allocating memory approximately 0 to 7 bytes under 192K in size causes the corresponding call to LocalFree to fail for certain memory blocks in this size range. The return code is ERROR_INVALID_PARAMETER.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winbase.h.
Link Library: Coredll.lib.

See Also

HeapCreate | LocalFree | LocalReAlloc | LocalSize


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show: