SetHandleSize

Shrink or expand a relocatable memory block

#include <Memory.h> Memory Manager

void SetHandleSize( theHandle, newSize );

Handle theHandle ; Handle to a valid relocatable memory block

Size newSize ; desired new size (a 32-bit value)

SetHandleSize shrinks or expands the size of a relocatable memory block

allocated via NewHandle.

theHandle is a handle leading to a relocatable block of memory. It is normally

a value obtained from NewHandle.

newSize is a 32-bit long integer. It specifies the desired new size of the

block. The actual size must be less than 16M (a 24-bit value).

Returns: none; the MemError function may return an Error Code of:

noErr (0) No error

memFullErr (-108) No room in heap

nilHandleErr (-109) Illegal operation on an empty block

memWZErr (-111) Illegal operation on a free block

Notes: In order for SetHandleSize to expand a relocatable block, the entire

block may need to be moved. If the block is currently locked (see HLock),

the expansion request will fail.

The common operations of concatenating data from a pointer or handle to

the end of another handle (thus expanding the handle's relocatable block),

are performed automatically by the OS Utility functions PtrAndHand or

Referenced by (40):