FB_FileOpen

Eingänge

VAR_INPUT
    sNetId     : T_AmsNetId;
    sPathName  : T_MaxString;
    nMode      : DWORD;
    ePath      : E_OpenPath := PATH_GENERIC;
    bExecute   : BOOL;
    tTimeout   : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

Vordefinierte Öffnungsmodi für nMode

Modus für das Öffnen der Datei. Die nachfolgend aufgeführten Codes sind die verschiedenen Öffnungsmodi, die bereits in der Bibliothek als Konstanten vordefiniert sind, und dem Baustein dementsprechend symbolisch übergeben werden können. Die Öffnungsmodi können durch ODER‑Verknüpfung kombiniert werden. Die Öffnungsmodi können auf ähnliche Weise wie die Öffnungsmodi der fopen-Funktion in C bzw. C++ kombiniert werden.

Ausgänge

VAR_OUTPUT
    bBusy  : BOOL;
    bError : BOOL;
    nErrId : UDINT;
    hFile  : UINT;(* file handle *)
END_VAR

Fehlercodes für hFile

Information:

Bei dem Öffnungsmodus dürfen maximal 3 Parameter mit ODER verknüpft werden:

Mode = [ Parameter1 ] OR [ Parameter2 ] OR [ Paramerter3 ]
Parameter1 darf nur einen unterstehenden Wert haben:

• FOPEN_MODEREAD
• FOPEN_MODEWRITE
• FOPEN_MODEAPPEND

Parameter2 darf nur einen unterstehenden Wert haben:

• FOPEN_MODEPLUS

Parameter3 darf nur einen unterstehenden Wert haben:

• FOPEN_MODEBINARY
• FOPEN_MODETEXT

Wenn kein Binär- oder Text-Mode angegeben wurde, öffnet die Datei in einem Mode der durch eine Betriebssystemvariable festgelegt ist. In den meisten Fällen öffnet die Datei dann im Text-Mode. Eine eindeutige Aussage ist jedoch nicht möglich. Es ist sinnvoll den Text oder Binärmode immer anzugeben. Diese Systemvariable kann nicht in der SPS geändert werden!
Daraus ergeben sich folgende zulässige Kombinationen:

Alle anderen Kombinationen sind falsch. Beispiele für unzulässige Öffnungsmodi:
FOPEN_MODEBINARY OR FOPEN_MODETEXT
FOPEN_MODEWRITE OR FOPEN_MODEAPPEND

Beispiel für den Aufruf des Bausteins in ST:

• Dateizugriff aus der SPS

Beispiel für den Aufruf des Bausteins in FBD:

PROGRAM Test
VAR
    fbFileOpen      : FB_FileOpen;
    bFileOpen       : BOOL;
    bFileOpenBusy   : BOOL;
    bFileOpenError  : BOOL;
    nFileOpenErrId  : UDINT;
    hFile           : UINT;
END_VAR

Hierbei soll die Datei TestFile2.txt im Root-Verzeichnis des Laufwerks C: im Textmode angelegt bzw. überschrieben werden.

Voraussetzungen