Carbon


SetApplLimit

Header: MacMemory.h Carbon status: Unsupported

Sets the application heap limit.

void SetApplLimit (
    void *zoneLimit
);
Parameter descriptions
zoneLimit

A pointer to a byte in memory demarcating the upper boundary of the application heap zone. The zone can grow to include the byte preceding zoneLimit in memory, but no further.

DISCUSSION

The SetApplLimit function sets the current application heap limit to zoneLimit. If the zone already extends beyond the specified limit, the Memory Manager does not cut it back but does prevent it from growing further.

Note that the zoneLimit parameter is not a byte count, but an absolute byte in memory. Thus, you should use the SetApplLimit function only with a value obtained from the Memory Manager functions GetApplLimit or ApplicationZone.

You cannot change the limit of zones other than the application heap zone.

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

AVAILABILITY

Not supported in Carbon. Not available in Carbon.


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