Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileDcreate()
Ddelete()                                                            GEMDOS

Syntax

LONG Ddelete( path )
char *path;

Function      Ddelete() removes a directory on the specified drive.

Opcode        58 (0x3A)

Availability  All GEMDOS versions.

Parameters    path contains the directory specification of the directory
              you wish to remove. path should not contain a trailing
              backslash. For valid examples of path, see the entry for
              Dcreate().

Binding       pea      path
              move.w   #$3A,-(sp)
              trap     #1
              addq.l   #6,sp

Return Value  Upon return one of four codes may result:
              E_OK   (  0):  Operation successful
              EPTHNF (-34):  Path not found
              EACCDN (-36):  Access denied
              EINTRN (-65):  Internal error

Caveats       Prior to GEMDOS version 0.15 a Ddelete() on a directory
              recently created will fail but a second attempt will not.

Comments      The directory being deleted must be empty or the call will
              fail.

See Also      Dcreate()