Funktionreferenz

_FTP_FileOpen

Beschreibung anzeigen in

Leitet den Zugang zu einer Datei auf einem FTP Server ein, um zu lesen oder zu schreiben

#include <FTPEx.au3>
_FTP_FileOpen ( $hConnect, $sFileName [, $iAccess = $GENERIC_READ [, $iFlags = $INTERNET_FLAG_TRANSFER_BINARY [, $iContext = 0]]] )

Parameter

$hConnect Der Rückgabewert von _FTP_Connect().
$sFileName Name der Datei, welche geöffnet werden soll.
$iAccess [optional] Das Attribut (Standard: $GENERIC_READ)
$iFlags [optional] Bestimmen die Umstände, unter denen die Übertragung stattfinden soll. Die Anwendung sollte einen Übermittlungstyp und irgend einen der Flags enthalten, die anzeigen, wie das Puffern kontrolliert wird.
Der Übermittlungstyp kann einer der folgenden Werte sein:
    $FTP_TRANSFER_TYPE_ASCII (1) - Übermittelt die Datei per FTP-ASCII-Übertragungsmethode (Typ A). Steuerungs- und Formatierungsinformationen werden entsprechend geändert.
    $FTP_TRANSFER_TYPE_BINARY (2) - Übermittelt die Datei per FTP-Abbild-Übertragungsmethode (Typ I). Die Datei wird exakt so, wie sie ist, ohne Änderungen übermittelt. (Standard)
    $FTP_TRANSFER_TYPE_UNKNOWN (0) - Setzt $FTP_TRANSFER_TYPE_BINARY als Standard
    $INTERNET_FLAG_TRANSFER_ASCII (1) - Übermittelt die Datei als ASCII
    $INTERNET_FLAG_TRANSFER_BINARY (2) - Übermittelt die Datei binär
Die folgenden Werte werden für die Kontrolle des Pufferns der Datei benutzt. Die Anwendung kann einen oder mehrere dieser Werte benutzen:
    $INTERNET_FLAG_HYPERLINK (0x00000400) - Erzwingt die Datei neu zu laden, wenn keine Fristablaufzeit oder Modifikationszeit vom Server zurückgegeben wird, wenn festgestellt wird, dass das Objekt vom Netzwerk neu zu laden ist.
    $INTERNET_FLAG_NEED_FILE (0x00000010) - Eine temporäre Datei wird erstellt, wenn die Datei nicht gepuffert werden kann.
    $INTERNET_FLAG_RELOAD (0x80000000) - Erzwingt das Herunterladen der angefragten Datei, des Objekts oder des Verzeichnisses vom originalen Server und nicht vom Cache.
    $INTERNET_FLAG_RESYNCHRONIZE (0x00000800) - Lädt HTTP-Quellen neu, wenn die Quelle nach dem letzten Download geändert wurde. Alle FTP und Gopher Quellen werden neu geladen.
$iContext [optional] Eine Variable, die den Definitionswert für die Anwendung enthält, der diese Suche mit Anwendungsdaten verbindet.
Dies wird nur benutzt, wenn die Anwendung bereits _FTP_SetStatusCallback()aufgerufen hat, um eine Status-Callbackfunktion zu setzen.

Rückgabewert

Erfolg: das Handle der FTP Datei für die Funktion _FTP_FileRead()
Fehler: 0 und setzt das @error Flag auf ungleich null

Verwandte Funktionen

_FTP_FileClose, _FTP_FileGet, _FTP_FilePut, _FTP_FileRead, _FTP_SetStatusCallback

Siehe auch

Suche nach FtpOpenFile in der MSDN Bibliothek.

Beispiel

#include <FTPEx.au3>
#include <MsgBoxConstants.au3>

_Example()

Func _Example()
    Local $sServer = 'ftp.csx.cam.ac.uk' ; UNIVERSITY OF CAMBRIDGE ANONYMOUS FTP SERVER
    Local $sUsername = ''
    Local $sPass = ''
    Local $sPath ='/pub/README'
    Local $hFile, $sText

    Local $hOpen = _FTP_Open('MyFTP Control')
    Local $hConn = _FTP_Connect($hOpen, $sServer, $sUsername, $sPass)

    If @error Then
        MsgBox($MB_SYSTEMMODAL, '_FTP_Connect', 'ERROR=' & @error)
    Else
        $hFile=_FTP_FileOpen($hConn,$sPath)
        $sText=BinaryToString(_FTP_FileRead($hFile,9999))  ;aus Datei lesen und in Stringformat wandeln
        _FTP_FileClose($hFile)
        MsgBox($MB_APPLMODAL, 'README: ',$sText)
     EndIf
    _FTP_Close($hConn)
    _FTP_Close($hOpen)
EndFunc   ;==>_Example