Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 LocalAllocor LocalReAllocfunction.

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