FB_FileRename
Mit diesem Funktionsbaustein kann eine Datei umbenannt werden.
VAR_INPUT
VAR_INPUT
sNetId : T_AmsNetId;
sOldName : T_MaxString;
sNewName : T_MaxString;
ePath : E_OpenPath := PATH_GENERIC; (* Default: generic file path*)
bExecute : BOOL;
tTimeout : TIME;
END_VAR
sNetId : Ist ein String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.
sOldName : Der alte Dateiname.
sNewName : Der neue Dateiname.
ePath : Über diesen Eingang kann ein TwinCAT - Systempfad auf dem Zielgerät zum öffnen der Datei angewählt werden.
bExecute : Durch eine steigende Flanke an diesem Eingang wird der Funktionsbaustein aktiviert.
tTimeout : Gibt die Timeout-Zeit an, die bei der Ausführung des ADS-Kommandos nicht überschritten werden darf.
VAR_OUTPUT
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrId : UDINT;
END_VAR
bBusy: Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.
bError: Sollte ein ADS-Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.
nErrId: Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.
Function specific ADS error code | Possible reason |
---|---|
0x70C | File not found. Invalid sOldName, sNewName or ePath parameter. |
Beispiel für den Aufruf des Bausteins in FBD:
PROGRAM Test
VAR
fbFileRename : FB_FileRename;
bFileRename : BOOL;
bFileRenameBusy : BOOL;
bFileRenameError: BOOL;
nFileRenameErrId: UDINT;
END_VAR

Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken |
---|---|---|
TwinCAT v2.8.0 | PC or CX (x86) | TcSystem.Lib |
TwinCAT v2.10.0 Build >= 1301 | CX (ARM) | TcSystem.Lib |