[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        PutDiskObject - write out a diskobject to disk.

   SYNOPSIS
        status = PutDiskObject(name, diskobj)
         D0                    A0      A1

        bool putdiskobject(strptr, struct diskobject *);

   FUNCTION
        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.

   INPUTS
        name -- name of the object (pointer to a character string)
        diskobj -- a pointer to a diskobject

   RESULTS
        status -- TRUE if the call succeeded else FALSE

   NOTES
        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.

   SEE ALSO
        dos.library/ioerr
        icon.library/deletediskobject
        icon.library/freediskobject
        icon.library/getdiskobject
        icon.library/geticontaglist
        icon.library/puticontaglist