c16_selclear

Mit dieser Funktion wird der Inhalt des Selektionspuffers komplett gelöscht. Eine Selektion muss vorher mit c16_selread() sperrend gelesen worden sein. Nach c16_selclear() verfügt die Selektion über eine leere Ergebnismenge. Dadurch kann beispielsweise die Ergebnismenge mit c16_selrecinsert() gefüllt werden.

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

Der Rückgabewert vom Typ int beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte).

• 0: _rOK
• 7: _rNoLock

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.