FB_FTP_FileListEx
Mit dem Funktionsbaustein FB_FTP_FileListEx können Datei- und Ordnernamen vom FTP-Server gelesen bzw. gesucht werden. Dieser Baustein benutzt eine bereits geöffnete Verbindung zu einem FTP-Server. Im Gegensatz zu dem Baustein FB_FTP_FileList werden auch Details zu den Dateien/Ordnern zurückgeliefert.
VAR_INPUT
VAR_INPUT
sNetID : T_AmsNetId := '';
hFTP : T_HFTP;
sMask : T_MaxString := '';
bRawValues : BOOL;
nIndex : UDINT;
pList : UDINT;
cbList : UDINT;
bExecute : BOOL;
tTimeout : TIME := T#20s;
END_VAR
sNetID : Ist ein String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.
hFTP : Handle des FTP Servers.
sMask : Suchmaske zum Filtern entsprechender Dateien.
Beispiel | |
|---|---|
*.* | Liest alle Dateien aus |
* | Liest alle Dateien und alle Ordnernamen aus |
*.txt | Liest alle Dateien mit der Endung "TXT" aus |
\Test\*.* | Liest alle Dateien aus dem Unterordner Test aus |
bRawValues : Gibt an in welcher Form die Dateiliste zurückgeliefert werden soll.
bRawValues := TRUE Informationen werden in Form eines T_MaxString Arrays zurückgeliefert.
bRawValues := FALSE Informationen werden in Form eines ST_FTP_FileDetails Arrays zurückgeliefert. (Wird nicht von jedem FTP Server unterstützt)
nIndex : Gibt den Index der ersten zu lesenden Datei an
pList : Gibt die Adresse des Arrays an in das die Dateiliste geschrieben werden soll. Maximale Arraygröße 256 Elemente.
cbList : Gibt die Größe des Arrays in Byte an
bExecute : Mit der steigende Flanke wird der Funktionsblock ausgeführt.
tTimeout : Gibt die Timeout-Zeit an.
VAR_OUTPUT
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrID : UDINT;
nItems : UDINT;
END_VAR
bBusy : Kommando wird gerade per ADS übertragen. Solange bBusy auf TRUE, wird kein neues Kommando angenommen.
bError : Wird TRUE, sobald ein Fehler eintritt.
nErrID : Liefert bei einem gesetzten bError-Ausgang den ADS Error Code.
nItems : Liefert die Gesamtanzahl der Dateilisteinträge zurück.
Voraussetzungen
Entwicklungsumgebung | Zielplattform | Einzubindende SPS Bibliotheken |
|---|---|---|
TwinCAT v2.10.0 | PC oder CX (x86) | TcFTPClient.Lib |
TwinCAT v2.10.0 | CX (ARM) |