LocalSize

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function returns the current size, in bytes, of the specified local memory object.

Syntax

UINT LocalSize(
  HLOCAL hMem
);

Parameters

  • hMem
    [in] Handle to the local memory object. This handle is returned by the LocalAlloc or LocalReAlloc function.

Return Value

In the debug configuration, where heap sentinels are enabled, the return value is the exact allocation size for the heap item.

In the retail configuration, where debug information is not included, the return value is the allocation size aligned to the block size (32 bytes).

Zero indicates that the specified handle is not valid or that the object has been discarded. To get extended error information, call GetLastError.

Remarks

The size of a memory block can be larger than the size requested when the memory was allocated.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Memory Management Functions
LocalAlloc
LocalReAlloc