GlobalUnWire

Syntax

BOOL GlobalUnWire(hMem)

This function unlocks a memory segment that was locked by the GlobalWire function and decreases the lock count by one.

The block is completely unlocked and subject to moving or discarding if the lock count is decreased to zero. Other functions also can affect the lock count of a memory object. See the description of the GlobalFlags function for a list of the functions that affect the lock count.

Each time an application calls GlobalWire for an object, it must eventually call Global-UnWire for the object.

Parameter Type/Description  

hMem HANDLE Identifies the segment that will be unlocked.  

Return Value

The return value specifies the outcome of the function. It is TRUE if the memory segment was unlocked, that is, its lock count was decreased to zero. Otherwise, it is FALSE.