HNoPurge

HNoPurge Disallow purging of relocatable data block

#include <Memory.h> Memory Manager

void HNoPurge( theHandle );

Handle theHandle ; handle to mark as un purgeable

HNoPurge tags a handle as un purgeable. If the handle is already un purgeable

(the default for newly- allocated handles), this function has no effect.

theHandle is a handle leading to a relocatable memory block. It is typically a

value obtained from NewHandle.

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

noErr (0) No error

nilHandleErr (-109) Illegal operation on an empty handle

memWZErr (-111) Illegal operation on a free block

Notes: Use HNoPurge to reverse the effect of a previous call to HPurge. Take

care to check that theHandle has not already been purged before calling this

function, e.g.:

HPurge( myHandle ); [TOKEN:12074] allow purge */

if ( *myHandle == 0 ) { [TOKEN:12074] it got purged */

ReallocHandle( myHandle, MYH_SIZE );

... regenerate the handle's data ...

}

HNoPurge( myHandle );