Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

LocalFree (Compact 2013)


This function frees the specified local memory object and invalidates its handle.

HLOCAL LocalFree(


Handle to the local memory object.

This handle is returned by either the LocalAlloc or LocalReAlloc function.

NULL indicates success. A handle to the local memory object indicates failure. To get extended error information, call GetLastError.

If the process tries to examine or modify the memory after it is freed, heap corruption can occur or an access violation exception (EXCEPTION_ACCESS_VIOLATION) can be generated.

If the hMem parameter is NULL, LocalFree ignores the parameter and returns NULL.

The LocalFree function will free a locked memory object. A locked memory object has a lock count greater than zero.

If an application is running under a debug version of the system, LocalFree issues a message that tells you that a locked object is being freed. If you are debugging the application, LocalFree enters a breakpoint just before freeing a locked object. This allows you to verify the intended behavior and then continue execution.





© 2015 Microsoft