LocalFlags

  UINT LocalFlags(hloc)    
  HLOCAL hloc; /* handle of local memory block */

This function returns information about the local memory block specified by the hloc parameter.

Parameters

hloc

Identifies the local memory block. This handle must have been created by a previous call to the LocalAlloc or LocalReAlloc function.

Return Value

The return value specifies the allocation flags and the lock count for the memory block, if the function is successful. If the local handle is not valid, the return value is LMEM_INVALID_HANDLE.

Comments

The high byte of the low word of the return value contains one of the following allocation flags:

Value Meaning

LMEM_DISCARDABLE The memory can be discarded.
LMEM_DISCARDED The memory has been discarded.

The low byte of the low word of the return value contains the lock count of the block. Use the LMEM_LOCKCOUNT mask to retrieve the lock-count value from the return value.

See Also

GlobalFlags, LocalAlloc, LocalLock, LocalReAlloc, LocalUnlock