HANDLE LocalDiscard(hMem)
This function discards the local memory block specified by the hMem parameter. The lock count of the memory block must be zero.
The local memory block is removed from memory, but its handle remains valid. An application can subsequently pass the handle to the LocalReAlloc function to allocate another local memory block identified by the same handle.
Parameter | Type/Description |
hMem | HANDLE Identifies the local memory block to be discarded. |
The return value specifies the outcome of the function. It is NULL if the function is successful. Otherwise, it is equal to hMem.