Inside Macintosh: Memory /

Chapter 2 - Memory Manager / Memory Manager Reference

Memory Manager Routines / Manipulating Heap Zones

InitApplZone

The Process Manager calls the InitApplZone procedure indirectly when it
starts up your application. You should never need to call it. It is documented for completeness only.

PROCEDURE InitApplZone;

DESCRIPTION

The InitApplZone procedure initializes the application heap zone and makes it the current zone. The Memory Manager discards the contents of any previous application zone and discards all previously existing blocks in that zone. The procedure sets
the zone's grow-zone function to NIL.

WARNING

Reinitializing the application zone from within a running program is dangerous, because the application's code itself normally resides in the application zone. To do so safely, you must make sure that the code containing the InitApplZone call is not in the application zone.

SPECIAL CONSIDERATIONS

You should not call InitApplZone at all, but, if you must, be sure not to call it at interrupt time because it could purge and allocate memory.

ASSEMBLY-LANGUAGE INFORMATION

The registers on exit for InitApplZone are

Registers on exit
D0	Result code

RESULT CODES

noErr

0

No error