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-FileDdelete()
Dcreate()                                                            GEMDOS

Syntax

LONG Dcreate( path )
char *path;

Function      Dcreate() creates a GEMDOS directory on the specified drive.

Opcode        57 (0x39)

Availability  All GEMDOS versions.

Parameters    path is a pointer to a string containing the directory
              specification of the directory to create. path should not
              contain a trailing backslash. Below are some examples and
              their results.

              path          Result

              C:\ONE\ATARI  Creates a folder named "ATARI" as
                            a subdirectory of "ONE" on drive 'C:'.

              \ONE\ATARI    Creates a folder named "ATARI" as
                            a subdirectory of "ONE" on the current GEMDOS
                            drive.

              ATARI         Creates a folder named "ATARI" as
                            a subdirectory of the current GEMDOS path on
                            the current GEMDOS drive.

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

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

Caveats       Prior to GEMDOS version 0.15 GEMDOS did not detect if the
              creation of a subdirectory failed and could therefore leave
              partially created directories on disk.

See Also      Ddelete()