C16_BinRename

C16_BinRename(const vPHANDLE aHdl, const vCHAR* aNewName) : vERROR

Binäre(s) Datei oder Verzeichnis umbenennen

Details

• aHdl: Deskriptor des Objektes / Verzeichnisses
• aNewName: Neuer Name
• Resultat: vERROR Fehlerwert
• Siehe: Befehle der Programmierschnittstelle , C16_BinCopy() , C16_BinMove()

Mit dieser Funktion wird das Objekt/Verzeichnis (aHdl) nach (aNewName) umbenannt. Das Objekt/Verzeichnis muss dazu exklusiv gesperrt sein (_BinLock bzw. _BinSingleLock).

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

• _rNoLock: Das Objekt ist nicht exklusiv gesperrt.
• _rExists: Das Objekt (aNewName) existiert bereits.
• _rDeadlock: Verklemmung aufgetreten.