C16_RecInsert
C16_RecInsert(const vPHANDLE aInstHdl, const vINT aFileNo, const vFLAGS aFlags) : vERROR
Datensatz einfügen
Details
- aInstHdl: Instanz-Handle
- aFileNo: Dateinummer
- aFlags: Datensatz sperren (_RecLock), nicht sperren (0)
- Resultat: vERROR Fehlerwert
- Siehe: Befehle der Programmierschnittstelle , C16_RecDelete() , C16_RecReplace()
Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. Mit dieser Funktion wird der momentan im Speicher stehende Datensatz (bestehend aus den aktuellen Feldinhalten) als neuer Satz in die angegebene Datei (aFileNo) eingefügt. Wird als Parameter (aFlags) die symbolische Konstante _RecLock übergeben, ist der Datensatz nach dem Einfügen gesperrt.
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 eingefügt oder zurückgespeichert werden, da ein Satz mit einem identischen eindeutigen Schlüsselwert bereits existiert.
- 10: _rDeadlock Der Datensatz konnte aufgrund einer Verklemmung nicht eingefügt werden.