# Funktionsreferenz

InetGet

Lädt eine Datei mittels des FTP- oder HTTP-Protokolls aus dem Internet herunter.

InetGet ( "URL", "filename" [, reload [, background]] )

Parameter

URL | URL der herunterzuladenden Datei. Bemerkungen dazu unten.
filename | Lokaler Dateiname, der heruntergeladenen Datei.
reload | [optional] 0 = (Standard) Hole die Datei wenn möglich aus dem lokalen Cache. 1 = Lade die Datei in jedem Fall neu von der Internetseite.
background | [optional] 0 = (Standard) Warte, bis der Download fertig ist, bevor das Skript weiter abgearbeitet wird. 1 = Sofort weiter machen und im Hintergrund herunterladen (siehe Bemerkungen).

Bemerkungen

Internet Explorer 3 oder neuer muss für diese Funktion installiert sein.
Der URL-Parameter sollte in folgender Form angegeben werden: "http://www.eine-seite.de/pfad/datei.html" - genauso, wie du die Adresse in deinen Web-Browser eingeben würdest.
Wenn du einen Benutzernamen und ein Passwort angeben willst/musst, musst du einfach vor den Servernamen "username:password@" anhängst, z.B.
"http://nutzer:passwort@www.eine-seite.de/pfad/seite.html"
Die InetGet-Funktion arbeitet mit http:// https:// und ftp:// - um beim FTP-Transfer den Übertragungstyp zu ändern, siehe FtpBinaryMode.
"background" Parameter
Standardmäßig wartet die Funktion, bis der Download fertig gestellt ist, bevor fortgefahren wird. Manchmal ist das - insbesondere bei großen Downloads - nicht erwünscht. Wenn der background-Parameter auf 1 gesetzt ist, wird das Skript sofort fortgesetzt und der Download wird im Hintergrund fortgesetzt. Wenn man sich in diesem Modus befindet, gibt es zwei Makros, die man verwendet, um den Download zu verfolgen:
@InetGetActive = 1: während des Downloads, oder 0: wenn er fertig gestellt ist.
@InetGetBytesRead = die Anzahl der bereits heruntergeladenen Bytes, oder -1, wenn ein Fehler aufgetreten ist.
Beachte, dass immer nur ein Download gleichzeitig laufen kann. Wenn du die Funktion trotzdem zum zweiten Mal aufrufst, wird sie fehlschlagen.
Wenn du einen Download abbrechen willst, übergibst du "abort" als ersten Parameter:

InetGet("abort")

Siehe auch

FtpBinaryMode (Option), FtpSetProxy, InetGetSize, HttpSetProxy

Beispiel

InetGet("http://www.mozilla.org", "C:\foo.html")
InetGet("http://www.autoitscript.com", "C:\mydownload.htm", 1)
InetGet("ftp://ftp.mozilla.org/pub/mozilla.org/README", "README.txt", 1)
; Advanced example - downloading in the background
InetGet("http://www.nowhere.com/somelargefile.exe", "test.exe", 1, 1)
While @InetGetActive
TrayTip("Downloading", "Bytes = " & @InetGetBytesRead, 10, 16)
Sleep(250)
Wend
MsgBox(0, "Bytes read", @InetGetBytesRead)