GlobalFree

  HGLOBAL GlobalFree(hglb)    
  HGLOBAL hglb; /* handle of object to free */

The GlobalFree function frees the specified global memory block (if it is not locked) and invalidates its handle.

Parameters

hglb

Identifies the global memory block to be freed.

Return Value

The return value is NULL if the function is successful. Otherwise, the return value is equal to hglb. Use the GetLastError function to obtain extended error information.

Comments

The GlobalFree function must not be used to free a locked memory block (a memory block with a lock count greater than zero)

Applications must not examine or modify memory after it has been freed.

See Also

GlobalFlags, GlobalAlloc