NeedSpace

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODStorageSystem

NeedSpace
The NeedSpace method is called to notify this storage system to reserve memory for future use.
void NeedSpace (in ODSize memSize, 
                in ODBoolean doPurge);
memSize
The size of the memory block desired, expressed as an unsigned 32-bit value.
doPurge
kODTrue if this operation should trigger the Purge method to obtain the requested memory, otherwise kODFalse.

DISCUSSION
Your part can call this method when it anticipates the need for a large memory block. This method is not guaranteed to generate the memory requested and should be used with caution as it may be a slow operation.
If memory cannot be allocated and the doPurge parameter is true, then this method calls the Purge method associated with this storage system's container objects (and transitively its document objects, draft objects, and storage-unit objects).