status = PutDiskObject(name, diskobj)
BOOL PutDiskObject(STRPTR,
struct DiskObject *);
This routine writes out a DiskObject structure, and its associated information. The file name of the info file will be the name parameter with ".info" postpended to it. If the call fails, FALSE will be returned. The reason for the failure may be obtained via IoErr().
As of release V2.0, PutDiskObject() (if successful) notifies Workbench when an icon has been created/modified.
Using this routine protects you from any future changes to the way icons are stored within the system.
It is recommended that if you wish to copy an icon from one place to another than you use
GetDiskObject() and PutDiskObject() and do not copy them directly.