Funktionsreferenz

_FTP_FindFileFirst

Sucht die erste Datei auf einem FTP-Server.

#Include <FTPEx.au3>
_FTP_FindFileFirst($l_FTPSession, $s_RemotePath, ByRef $h_Handle [, $l_Flags = 0 [, $l_Context = 0]])

 

Parameter

$l_FTPSession Rückgabe von _FTP_Connect().
$s_RemotePath Pfad auf dem Server, in dem die Datei gesucht wird.
$h_Handle Gibt ein Handle zurück, das für _FTP_FindFileNext() oder _FTP_FindFileClose() benötigt wird.
$l_Flags [optional] Siehe Bemerkungen.
$l_Context [optional] Eine Variable, die eien anwendungsdefinierten Wert enthält, der diese Suche mit beliebigen Anwendungsdaten verknüpft.
Dies wird nur benutzt, wenn die Anwendung bereits die Funktion _FTP_SetStatusCallback() aufgerufen hat, um eine Status Callbackfunktion zu installieren.

 

Rückgabewert

Erfolg: Ein Array, siehe Bemerkungen.
Fehler: 0 und setzt @ERROR

 

Bemerkungen

Im Erfolgsfall wird ein Array mit diesen Inhalten zurückgegeben:
[0] - Anzahl der Elemente
[1] - Dateiattribute
[2] - Erstellzeit (Lo)
[3] - Erstellzeit (Hi)
[4] - Zugriffszeit (Lo)
[5] - Zugriffszeit (Hi)
[6] - Letzter Schreibzugriff (Lo)
[7] - Letzter Schreibzugriff (Hi)
[8] - Dateigröße (Hi)
[9] - Dateigröße (Lo)
[10] - Dateiname
[11] - Alternativname

$l_Flags kann eine Kombination aus $INTERNET_FLAG_HYPERLINK, $INTERNET_FLAG_NEED_FILE, $INTERNET_FLAG_NO_CACHE_WRITE, $INTERNET_FLAG_RELOAD und $INTERNET_FLAG_RESYNCHRONIZE sein.

 

Verwandte Funktionen

_FTP_FindFileNext, _FTP_FindFileClose, _FTP_SetStatusCallback

 

Siehe auch

Suche in der MSDN Bibliothek nach FtpFindFirstFile

 

Beispiel


#include <FTPEx.au3>

$server = 'ftp.csx.cam.ac.uk'
$username = ''
$pass = ''

$Open = _FTP_Open('Mein FTP-Control')
$Conn = _FTP_Connect($Open, $server, $username, $pass)

Local $h_Handle
$aFile = _FTP_FindFileFirst($Conn, "/pub/software/programming/pcre/", $h_Handle)
ConsoleWrite('$Filename = ' & $aFile[10] & ' Attribute = ' & $aFile[1] & '  -> Fehlercode: ' & @error & @crlf)

$FindClose = _FTP_FindFileClose($h_Handle)

$Ftpc = _FTP_Close($Open)