Zum Hauptinhalt springen

C16_RecReplace

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

Datensatz ersetzen

Details

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. Diese Funktion speichert einen Datensatz in die angegebene Datei (aFileNo) zurück, der zuvor geladen und gesperrt wurde. Ein nicht gesperrter Satz kann nicht zurückgespeichert werden. Alle Felder des gelesenen Satzes können vor dem Rückspeichern verändert werden (inkl. aller Schlüsselfelder). Dabei ist zu beachten, dass eindeutige Schlüsselwerte nicht bereits in der Datei enthalten sein dürfen. Durch (aFlags) kann angegeben werden, ob der Datensatz nach dem Rückspeichern weiter gesperrt bleiben soll oder nicht. Wird keine der beiden Optionen benutzt, so wird der Satz entsperrt.

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.
  • 6: _rExists Der Datensatz konnte nicht zurückgespeichert werden, da ein Satz mit einem identischen eindeutigen Schlüsselwert bereits existiert.
  • 7: _rNoLock Der Datensatz konnte nicht zurückgespeichert werden, da er nicht gesperrt ist.
  • 10: _rDeadlock Der Datensatz konnte aufgrund einer Verklemmung nicht ersetzt werden.