Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.15.19  Dxopendir                                                 TOS

 Name:         »Dxopendir« - öffnet ein Verzeichnis zum Lesen.

 Gemdosnummer: 1296

 Deklaration:  int32_t Dxopendir ( int8_t *name, int16_t flag );

 Beschreibung: Dxopendir ruft das normale Dopendir auf, speichert 
               allerdings dann das zurückgegebene Handle und Flag in 
               einer verketten Liste so wissen Dreaddir und Dxreaddir 
               das sie bei diesem Verzeichnis wandeln müssen. 
               Dcloseddir löscht das Handle wieder aus der Liste.

               Dreaddirund Dxreaddir wandeln den zurück gegebenen 
               Namen in Kleinbuchstaben.

               Die Funktion öffnet das Verzeichnis name zum Lesen. Der 
               Parameter flag beschreibt die Art und Weise, wie das 
               Verzeichnis geöffnet werden soll:

                flag  Bedeutung

                0     Normalmodus
                      In diesem Modus wird versucht, die Länge von 
                      Dateinamen nicht zu begrenzen. Darüber hinaus 
                      gibt Dreaddir in diesem Modus eine Indexnummer 
                      (ähnlich den UNIX inode's) in den ersten 4 Bytes 
                      des Dateinamens zurück.
                1     Kompatibilitätsmodus
                      In diesem Modus verhalten sich Dateisysteme so, 
                      als würden Fsfirst- bzw. Fsnext-Aufrufe benutzt. 
                      Insbesondere werden Dateinamen nach DOS- 
                      Konvention auf 8+3 Zeichen verkürzt, wenn dies 
                      möglich ist.

               Neuere Programme sollten nach Möglichkeit immer den 
               Normalmodus benutzen, um die volle Funktionalität zu 
               nutzen.

 Ergebnis:     Die Funktion liefert im Erfolgsfall eine 32bit 
               Verzeichnis-Handle. Diese darf auch negativ sein, 
               enthält aber auf keinen Fall den Wert 0xff im obersten 
               Byte, wodurch es von Fehlern unterschieden werden kann.

               Im Fehlerfall sind folgende Rückgabewerte möglich:

                EPTHNF :  name ist kein gültiges Verzeichnis
                EACCDN :  Das Verzeichnis ist von diesem Programm 
                          nicht ansprechbar.
                ENSMEM :  Der Kernel kann für diese Operation keinen 
                          Speicher allozieren.

 Verfügbar:    Wenn die Systemerweiterung Dir_Lwr (liegt Égale 4.2 
               bei) installiert ist. Legt den Cookie 'DYDL' an.

 Gruppe:       Verzeichnisfunktionen

 Querverweis:  Binding   Dclosedir   Dreaddir   Drewinddir   Pdomain