a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 icon.library
  AddFreeList
  BumpRevision
  ChangeToSelectedIconColor
  DeleteDiskObject
  DrawIconStateA
  DupDiskObjectA
  FindToolType
  FreeDiskObject
  FreeFreeList
  GetDefDiskObject
  GetDiskObject
  GetDiskObjectNew
  GetIconRectangleA
  GetIconTagList
  IconControlA
  LayoutIconA
  MatchToolValue
  NewDiskObject
  PutDefDiskObject
  PutDiskObject
  PutIconTagList
Include
GuruMeditation
Docs » Autodocs » icon.library » DeleteDiskObject

NAME

	DeleteDiskObject - Delete a Workbench disk object from disk.     (V37)

SYNOPSIS

	result = DeleteDiskObject(name)
D0 A0
BOOL DeleteDiskObject(STRPTR);

FUNCTION

	This routine will try to delete a Workbench disk object from disk.
The name parameter will have ".info" postpended to it, and the
icon file of that name will be deleted. If the call fails,
it will return FALSE. The reason for the failure may be obtained
via dos.library/IoErr().
This call also updates the Workbench screen if needed.
Using this routine protects you from any future changes to
the way icons are stored within the system.

INPUTS

	name -- name of the object (char *)

RESULT

	result -- TRUE if it worked, FALSE if not.

EXAMPLE

	error = 0;
/* Check if you have the right library version */
if(IconBase->lib_Version > 36)
{
if (!DeleteDiskObject(name))
error = IoErr();
}
else
{
/* Delete name plus ".info" */
}
if (error != 0)
{
/* Do error routine...*/
}

SEE ALSO

dos.library/IoErr(), icon.library/PutDiskObject(), icon.library/GetDiskObject(), icon.library/FreeDiskObject(), icon.library/GetIconTagList(), icon.library/PutIconTagList()

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Sanity

SNT
TSL
PDX
SPB

Comments:

$VER: d0.se 1.14 Copyright © 2011-2020 Tobias Geijersson support at d0 dot se