FB_FileRename

FB_FileRename 1:

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
FB_FileRename 2:

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