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-FileDgetpath()
Dsetpath()                                                           GEMDOS

Syntax

LONG Dsetpath( path )
char *path;

Function      Dsetpath() sets the path of the current GEMDOS drive.

Opcode        59 (0x3B)

Availability  All GEMDOS versions.

Parameters    path is a pointer to a character buffer containing the new
              path specification for the current GEMDOS drive.

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

Return Value  Dsetpath() returns one of two return codes on function
              exit:
              E_OK (0):  Operation successful
              EPTHNF (-34): Path not found

Caveats       You may specify a drive letter and colon in the input path
              specification to set the path of a particular drive but this
              feature is unstable in all versions of GEMDOS and may
              confuse drive assignments. It is therefore advised that this
              feature be avoided.

See Also      Dgetpath()