FRename()

Allgemeines

Die Funktion fRename() erlaubt es, eine Datei auf Betriebssystemebene umzubenennen.

Da fRename() die Einstellungen von SET DEFAULT und SET PATH nicht berücksichtigt, muss der Dateiname um Laufwerk und Pfad ergänzt werden, wenn sich die Datei nicht im aktuellen Verzeichnis befindet.

Syntax

fRename(<cOldName>, <cNewName>) => nSuccess

Parameter

<cOldName> gibt an, welche Datei umbenannt werden soll.

<cNewName> gibt an, wie der neue Name der Datei lauten soll. Ohne Angabe von Laufwerk und Pfad wird die Datei an ihrem aktuellen Ort nur umbenannt. Werden Laufwerk und/oder Pfad angegeben, wird die Datei an den angegebenen Ort verschoben und umbenannt.

Rückgabewert

nSuccess enthält 0, wenn der Prozess fehlerfrei beendet wurde. Anderfalls enthält nSuccess den Wert -1, und über die Funktion fError() kann ermittel werden, welcher Fehler aufgetreten ist.

benötigte DLLs bzw. Include-Dateien

XppRT1.lib

Zuordnung

Low Level Dateifunktionen