Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.16.9  Dgetpath                                                   TOS

 Name:         »Get path« - Obtain current path specification.

 Opcode:       71

 Syntax:       int16_t Dgetpath ( int8_t *path, int16_t driveno );

 Description:  The GEMDOS routine Dgetpath obtains the current 
               directory on the drive driveno. The designation of the 
               drives are coded in the parameter driveno as follows:

                driveno  Meaning

                0        Current drive
                1        Drive A:
                2        Drive B:
                3        Drive C: (etc.)

               The path is stored in buffer path as a string. As the 
               maximum path length is not restricted in GEMDOS, and 
               can be obtained only with the existence of the function 
               Dpathconf, the receiving buffer should offer sufficient 
               space (256 bytes ought to be enough).

 Return value: The function can return the following results:

                E_OK    :  No eror has arisen 
                EDRIVE  :  Invalid drive number 

 Availability: All GEMDOS versions.

 Group:        Directory functions

 See also:     Binding   Dsetpath