Carbon


HLockHi

Header: MacMemory.h Carbon status: Supported

Moves a relocatable block to the top of the heap and locks the block.

void HLockHi (
    Handle h
);
Parameter descriptions
h

A handle to a relocatable block.

DISCUSSION

The HLockHi function attempts to move the relocatable block referenced by the handle h upward until it reaches a nonrelocatable block, a locked relocatable block, or the top of the heap. Then HLockHi locks the block.

The HLockHi function is simply a convenient alternative to using the two functions MoveHHi and HLock.

Call the function MemError to get the result code. See “Result Codes”.

Because the HLockHi function moves memory, you should not call it at interrupt time.

Do not call HLockHi on blocks in the system heap. Do not call HLockHi from a desk accessory.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)