C16_BinDelete

Mit dieser Funktion wird ein binäres Objekt gelöscht.

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der an die Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben.

In (aDirHdl) wird der Deskriptor des Ausgangsverzeichnisses angegeben.

info

Sofern das Ausgangsverzeichnis dem Wurzelverzeichnis entspricht, wird in (aDirHdl) 0 angegeben. Das Wurzelverzeichnis ist immer vorhanden und braucht auch nicht geöffnet zu werden.

Folgende Optionen (aFlags) können angegeben werden:

• _BinClearOnly

  Der Inhalt des Objekts (aName) wird gelöscht.

• _BinDirectory

  Das Verzeichnis (aName) wird gelöscht.

• _BinDeleteAll

  Das Verzeichnis (alpha1) alle Unterverzeichnsse und enthaltenen Objekte werden gelöscht. Die Option _BinDirectory muss angegeben sein.

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler), einen negativen Fehlerwert (siehe Fehlerwerte) oder einen der folgenden Fehlerwerte:

• _rLocked: Das Objekt (aName) ist gesperrt.
• _rDeadlock: Verklemmung aufgetreten.
• C16ERR_BIN_NAME_INVALID: Objektname (aName) ist ungültig.
• C16ERR_BIN_NO_PATH: Das Objekt (aName) existiert nicht.