C16_BinDelete

C16_BinDelete(const vPHANDLE aInstHdl, const vPHANDLE aDirHdl, const vCHAR* aName, vFLAGS aFlags) : vERROR

Binäres Objekt oder Verzeichnis löschen

Details

• aInstHdl: Instanz-Handle
• aDirHdl: Deskriptor des Elternverzeichnisses
• aName: Objektname
• aFlags:
  • Optionen:
  • _BinClearOnly
  • _BinDirectory
  • _BinDeleteAll
• Resultat: vERROR Fehlerwert
• Siehe: Befehle der Programmierschnittstelle , C16_BinOpen()

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.