Funktionsreferenz

_FTP_ProgressUpload

Lädt eine Datei im Binärmodus hoch und zeigt einen Fortschrittsbalken, bzw. ruft eine benutzerdefinierte Funktion auf

#Include <FTPEx.au3>
_FTP_ProgressUpload($l_FTPSession, $s_LocalFile, $s_RemoteFile [, $FunctionToCall = ""])

Parameter

$l_FTPSession	Rückgabe von _FTP_Connect().
$s_LocalFile	Die lokale Datei.
$s_RemoteFile	Die auf dem Server zu erzeugende Datei.
$FunctionToCall	[optional] Eine Funktion, welche einen Fortschrittsbalken aktualisiert oder auf Benutzereingaben reagiert, wie etwa einen Klick auf Abbrechen oder das Schließen der Anwendung. (Mehr Info am Ende des Kommentars)

Rückgabewert

Erfolg:	1
Fehler:	0 und setzt @error
@error:	-3 - Fehler beim Erzeugen der Datei
	-4 - Fehler beim Schreiben in die Datei
	-5 - Fehler beim Schließen der Datei
	-6 - Upload durch die Fortschrittsfunktion abgebrochen und Rückgabewert entspricht der aufgerufenen Funktion

Bemerkungen

Information über $FunctionToCall:
   Parameter: $Percentage - Fortschritt in Prozent
   Rückgabewerte: Download fortsetzen - 1
                  Download abbrechen - 0 oder negativ
                       Diese Werte werden ebenfalls von _FTP_ProgressUpload() zurückgegeben,
                       so kann man auf verschiedene Ereignisse reagieren, wie z.B. einen Abbruch vom Benutzer, Schließen der Anwendung oder ein TimeOut von irgendwas.
   Beispiele:
                   Func _UpdateProgress($Percentage)
                      ProgressSet($Percentage,$Percentage &"%")
                      If _IsPressed("77") Then Return 0 ; Abbruch mit F8
                      Return 1 ; Upload fortsetzen
                   Endfunc

                   Func _UpdateProgress($Percentage)
                      GUICtrlSetData($ProgressBarCtrl,$Percentage)
                      Switch GUIGetMsg()
                         Case $GUI_EVENT_CLOSE
                            Return -1 ; _FTP_UploadProgress Bricht mit -1 ab, so kann man die Anwendung hinterher schließen
                        Case $Btn_Cancel
                           Return 0 ; Einfach abbrechen, ohne speziellen Rückgabewert
                      EndSwitch
                      Return 1 ; Ansonsten Upload fortsetzen
                   Endfunc

Verwandte Funktionen

Keine.