Zum Hauptinhalt springen

c16_selrecinsert

c16_selrecinsert(aSelection : resource, aFileNo : int) : int​

Datensatz der Selektion hinzufügen

Details

Diese Funktion fügt den aktuell im Hauptspeicher befindlichen Datensatz der Datei (aFileNo) in eine Ergebnismenge der Selektion im Puffer ein. Dies ist sowohl bei der Hauptergebnismenge als auch bei verknüpften Ergebnismengen möglich. Für die Hauptergebnismenge kann auch 0 in (aFileNo) übergeben werden.

Im Parameter (aSelection) wird das von c16_selopen() bereitgestellte Selektionsobjekt übergeben.

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

  • 0: _rOK Datensatzoperation erfolgreich.
  • 3: _rExists Der Datensatz ist bereits in der Selektion vorhanden.
  • 6: _rNoLock Die Selektion ist nicht gesperrt.
  • 5: _rDeadlock Es ist eine Verklemmung aufgetreten.

Tritt bei der Verarbeitung ein Fehler auf, wird der Fehlerwert von der Anweisung zurückgegeben. Der Fehler kann ebenfalls mit den Anweisungen c16_error() oder c16_errortext() ermittelt werden. Folgende Fehler können auftreten:

  • C16_OK (0): Kein Fehler aufgetreten.
  • C16ERR_ARGS_FORMAT (-251): Anzahl der Argumente oder Typ eines Arguments ungültig.
  • C16ERR_ARGS_SELECTION (-255): Kein Selektionsobjekt in aSelection übergeben.
  • C16ERR_NO_FILE (-601): Datei nicht vorhanden.