Zum Hauptinhalt springen

c16_seldelete

c16_seldelete(aConnection : resource, aFileNo : int[, aName : string]) : int​

Selektion löschen

Details

Mit dieser Funktion kann eine bestehende Selektion komplett entfernt werden, einschließlich eventuell vorhandener Ergebnismengen. Dabei wird in Parameter (aConnection) das von c16_connect() bereitgestellte Verbindungsobjekt übergeben. Die Nummer der Datei und der Name der zu löschenden Selektion wird in (aFileNo) und (aName) angegeben.

Über den Rückgabewert kann geprüft werden, ob die Selektionsmenge gelöscht werden konnte.

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.
  • 1: _rLocked Selektion ist vorhanden und von einem anderen Benutzer gesperrt.
  • 5: _rNoRec Die Selektion wurde nicht gefunden.

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_CONNECTION (-254): Kein Verbindungsobjekt in aConnection übergeben.