GetDiskObject

read in a Workbench disk object from disk.

This routine reads in a Workbench disk object in from disk. The name parameter will have ".info" postpended to it, and the icon file of that name will be read. If the call fails, it will return NULL. The reason for the failure may be obtained via IoErr().

Using this routine protects you from any future changes to the way icons are stored within the system.

A FreeList structure is allocated just after the DiskObject structure; FreeDiskObject makes use of this to get rid of the memory that was allocated.

name

name of the object (STRPTR) or NULL if you just want a DiskObject structure allocated for you (useful when calling AddAppIcon() in workbench.library).

diskobj

the Workbench disk object in question

dos.library/IoErr(), icon.library/DeleteDiskObject(), icon.library/FreeDiskObject(), icon.library/GetDiskObjectNew(), icon.library/GetIconTagList(), icon.library/NewDiskObject(), icon.library/PutDiskObject(), icon.library/PutIconTagList(), workbench.library/AddAppIconA()