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.

Eingänge

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

Name	Typ	Beschreibung
sNetID	T_AmsNetId	Ein String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.
hFTP	T_HFTP	Handle des FTP Servers.
sMask	T_MaxString	Suchmaske zum Filtern entsprechender Dateien: . 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	BOOL	Gibt an, in welcher Form die Dateiliste zurückgeliefert werden soll: TRUE: Informationen werden in Form eines T_MaxString Arrays zurückgeliefert. FALSE: Informationen werden in Form eines ST_FTP_FileDetails Arrays zurückgeliefert. (Wird nicht von jedem FTP Server unterstützt).
nIndex	UDINT	Gibt den Index der ersten zu lesenden Datei an.
pList	UDINT	Gibt die Adresse des Arrays an in das die Dateiliste geschrieben werden soll. Maximale Arraygröße 256 Elemente.
cbList	UDINT	Gibt die Größe des Arrays in Byte an.
bExecute	BOOL	Mit der steigenden Flanke wird der Funktionsblock ausgeführt.
tTimeout	TIME	Gibt die Timeout-Zeit an.

Ausgänge

VAR_OUTPUT
     bBusy : BOOL;
     bError: BOOL;
     nErrID: UDINT;
     nItems: UDINT;
END_VAR

Name	Typ	Beschreibung
bBusy	BOOL	Kommando wird gerade per ADS übertragen. Solange bBusy auf TRUE, wird kein neues Kommando angenommen.
bError	BOOL	Wird TRUE, sobald ein Fehler eintritt.
nErrID	UDINT	Liefert bei einem gesetzten bError-Ausgang den ADS Error Code.
nItems	UDINT	Liefert die Gesamtanzahl der Dateilisteinträge zurück.

Voraussetzungen

Entwicklungsumgebung	Zielplattform	Einzubindende SPS-Bibliotheken
TwinCAT v3.0 Build 3102	PC oder CX (x86)	Tc2_FTP