FATS - Fast Access Tree System Inhaltsverzeichnis Programmierschnittstellen Watcom C/C++ für Windows 95/NT

Watcom C/C++ für Windows 95/NT

---

 
Windows Bibliotheken FATS_W32.DLL bzw. FATSXW32.DLL

Im Lieferumfang der FATS-Version für Windows 95/NT befinden sich die Dynamischen Bibliotheken FATS_W32.DLL (Basisversion) bzw. FATSXW32.DLL (Erweiterte Version), die Sie in das Systemverzeichnis von Windows kopieren müssen:

COPY FATS?W32.DLL \WINDOWS\SYSTEM

Die Bibliotheken exportieren folgende Funktionen:

unsigned long __stdcall FATSLibInit(unsigned long datasize, unsigned long sign);

unsigned long __stdcall FATSLibExit(unsigned long lpFatsdata);

unsigned long __stdcall FATSLibCallA(char *szCmnd, int *nErrorcode,char *szFatsKey, unsigned long lpFatsdata);

#define FATSLibCall FATSLibCallA

Auf der Diskette finden Sie im Verzeichnis WIN_32I\C\WATCOM die Importbibliotheken FATS_W32.LIB (Basisversion) bzw. FATSXW32.LIB (Erweiterte Version), die Sie zu Ihren Programmen linken können.Diese Bibliotheken wurden speziell für Watcom C entwickelt und liegen im Intel-Objektformat vor.

Bevor Sie die FATS-Befehle aus Ihrem Watcom-C Programm verwenden können, müssen Sie FATS einen Datenbereich zuweisen:

lpFatsdata = FATSLibInit(0, 2);

Der erste Parameter bestimmt die Größe des FATS-Datenbereichs. Wenn Sie hier eine Null angeben, dann wird der minimal benötigte Speicherplatz reserviert (ca. 18-20 KB). Der zweite Parameter bestimmt die eingesetzte Programmiersprache, für C Programme muß dieser Wert gleich 2 sein. Die Adresse des Datenbereichs wird in der Variable lpFatsdata zurückgegeben.

Vor dem Beenden des Anwendungsprogrammes sollten Sie den mit der Funktion FATSLibInit reservierten Speicherbereich wieder freigeben. Dafür steht die Funktion FATSLibExit zur Verfügung:

lpFatsdata = FATSLibExit(lpFatsdata);

Obwohl der Speicherbereich notfalls auch vom Betriebssystem automatisch freigegeben würde, ist dieser Befehl nützlich, da er sämtliche noch geöffneten FATS-Dateien ordnungsgemäß schließt.

 
Aufruf von FATS

FATS-Befehle werden mit der Funktion FATSLibCall ausgeführt:

dwRecno = FATSLibCall(szCmnd, &nErrorcode, szFatsKey, lpFatsdata);

Bedeutung der verwendeten Parameter:

szCmnd	Befehlsstring
nErrorcode	Fehlercode von FATS
szFatsKey	Schlüsselstring von FATS
lpFatsdata	Adresse des FATS-Datenbereichs
Rückgabe:	Datensatznummer

 
Testprogramme

Auf der FATS-Diskette für Windows 95/NT befinden sich im Verzeichnis WIN_32I\C\WATCOM Testprogramme, anhand derer Sie die Verwendung von FATS studieren können:

tst1_ger.c	Testprogramm für Watcom-C für Windows
rebldger.c	Wiederherstellung einer Indexdatei ('BK', 'DL')

Bei der erweiterten Version von FATS befinden sich zusätzlich die folgenden Testprogramme im Verzeichnis:

tst2_ger.c	Matchcode-Suche im Kundenstamm
mcsort.c	Anwendung des Key-Flags beim Kommando 'MC'
reindger.c	Schnelle Re-Indizierung (Befehl 'XB')

© 2008  GCS Software, Udo Gertz