1.2.69 DbsOpenTable – Öffnet eine infra-Datenbank
DbsOpenTable( strBufName, lQuiet,lKlingel,lUserRecFree,lRc);
Argumente
StrBufName
Datenbankdatei, die geöffnet werden soll.
 
lQuiet:
0
lKlingel und lUserRecFree sind nach dem Aufruf definiert
1
lKlingel und lUserRecFree sind nach dem Aufruf nicht definiert
 
lKlingel: (Rückgabeparameter)
1
Tagesklingel wurde überschritten, falls mit lQuiet=0 übergeben wurde
 
lUserRecFree: (Rückgabeparameter)
n
Gibt die Anzahl freier Benutzersätze in der Datenbank zurück, falls mit lQuiet=0 übergeben wurde.
 
lRc
Rückgabewert des Kernsystems
Rückgabewerte
lRc == 0:
Routine ohne Fehler ausgeführt
lRc == 4:
Datenbankdatei wird von keinem der geladenen Datenbankclients unterstützt (Datei fehlte bereits beim DbsConnect)
lRc == 185
Datei kann physikalisch nicht geöffnet werden (wurde evtl. nach dem DbsConnect gelöscht oder Fehler im Dateisystem)
lRc == 5
Datei ist bereits offen
lRc == 50
Zu viele Dateien offen, gewünschte Datei wurde nicht geöffnet.
lRc <sonst>
sonstiger Fehler aufgetreten
Beschreibung
Diese Funktion trägt die mit Hilfe des Wertes von strBufName identifizierte Datei in eine FileTable ein und öffnet sie anschließend und initialisiert die Verwaltungsdaten dieser Tabelle in der Datenbank.
Wurde als Parameter lQuiet=0 mitgegeben, wird die Anzahl der noch freien Sätze ermittelt und ggf. eine Überschreitung der Tagesklingel gemeldet.
Im Rückgabeparameter lKlingel wird 1 zurückgegeben, sobald der Tagesklingelwert unterschritten wurde (unabhängig davon, ob eine Meldung ausgegeben wird oder nicht).
Die Anzahl der freien Sätze wird in lUserRecFree zurückgeliefert.
Hinweis: Um zu prüfen, ob eine bestimmte Datenbankdatei vorhanden ist oder nicht, sollte der Returncode sicherheitshalber auf 4 und 185 geprüft werden. Beides können Indikatoren dafür sein, ob die Datei physikalisch vorhanden ist, oder nicht.
Funktionsart
STPFunktion
Beispiel
DbsOpenTable( strDDF, 0, lKlingel, lUserRecordsFree, lRc );
if( lRc != 0 )
       {
       MessageBox( "Fehler beim öffnen der infra:Datei DDFDF", 0 );
       Exit();
       }