Zum Hauptinhalt springen

C16_RecDelete

C16_RecDelete(const vPHANDLE aInstHdl, const vINT aFileNo, const vFLAGS aFlags) : vERROR​

Datensatz löschen

Details

Mit dieser Funktion kann ein Datensatz in der Datei (aFileNo) gelöscht werden. Dabei wird immer über den ersten Schlüssel zugegriffen. Der Satz wird nur bei dem Ergebnis _rOk gelöscht. Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. Der Parameter (aFlags) bestimmt, welcher Datensatz gelöscht wird. Folgende symbolischen Konstanten können angegeben werden:

  • _RecFirst: Der erste Satz wird gelöscht.
  • _RecLast: Der letzte Satz wird gelöscht.
  • _RecNext: Der nächste Satz wird gelöscht.
  • _RecPrev: Der vorherige Satz wird gelöscht.

Der Erfolg der Datensatzoperation wird von der Funktion zurückgegeben. Bei der Überprüfung können folgende symbolische Konstanten verwendet werden:

  • 0: _rOK Datensatzoperation erfolgreich.
  • 1: _rLocked Der Datensatz konnte nicht gelöscht werden, da er von einem anderen Benutzer gesperrt ist.
  • 3: _rNoKey In der Datei ist kein Satz mit dem gewünschten Schlüsselwert vorhanden. Es wurde der Satz mit dem nächst größeren Schlüsselwert geladen.
  • 4: _rLastRec In der Datei ist weder ein Satz mit dem gewünschten Schlüsselwert noch ein Satz mit einem größeren Schlüsselwert vorhanden. Es wurde der Satz mit dem größten Schlüsselwert geladen.
  • 5: _rNoRec Es wurde kein Satz geladen, da entweder die Datei leer ist, oder kein vorhergehender bzw. nachfolgender Satz existiert.
  • 10: _rDeadlock Der Datensatz konnte aufgrund einer Verklemmung nicht gelöscht werden.