Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 2 - Scrap Manager / Scrap Manager Reference

Routines / Transferring Data Between the Scrap in Memory and the Scrap on Disk

LoadScrap

You can use the LoadScrap function to read the scrap from the scrap file into memory.

FUNCTION LoadScrap: LongInt;

DESCRIPTION

The LoadScrap function allocates memory in your application's heap to hold the scrap and then reads the scrap from the scrap file into memory. The scrap file is located in the System Folder of the startup volume and has the filename (usually "Clipboard") as indicated by the scrapName field of the scrap information record. If the scrap is already in memory, LoadScrap does nothing.

LoadScrap returns as its function result a long integer corresponding to a result code.

SPECIAL CONSIDERATIONS

The LoadScrap function may move or purge memory blocks in the application heap. Your application should not call this function at interrupt time.

RESULT CODES

noErr	0	No error
ioErr	-36	I/O error
memFullErr	-108	Not enough memory in heap zone