FB_LicFileCopyFromDongle

Der Funktionsbaustein kopiert eine Datei vom Lizenz-Dongle auf die Festplatte. Ist die Datei größer als der Buffer (cbCopyLen), dann wird die Datei automatisch in mehreren Lese- und Schreibzugriffen kopiert, bis die komplette Datei kopiert ist, erst dann geht das bBusy auf FALSE.
 Eingänge
VAR_INPUT
    sNetIdSrc         : T_AmsNetId;
    nPortSrc          : UINT;
    sNetIdDest        : T_AmsNetId;
    sFileNameSrc      : STRING;
    sFilePathNameDest : T_MaxString;
    pCopyBuff         : PVOID;
    cbCopyLen         : UDINT;
    bExecute          : BOOL;
    dwPassCode        : DWORD;
    tTimeout          : TIME    := DEFAULT_ADS_TIMEOUT;
END_VARName  | Typ  | Beschreibung  | 
|---|---|---|
sNetIdSrc  | T_AmsNetId  | AmsNetId (AMS-Netzwerkkennung) des Lizenz-Dongles. 
  | 
nPortSrc  | UINT  | AMS-Port des Lizenz-Dongles 
  | 
sNetIdDest  | T_AmsNetId  | AmsNetId (AMS-Netzwerkkennung) des TwinCAT-Rechners. Für den lokalen Rechner kann auch ein Leerstring angegeben werden.  | 
sFileNameSrc  | STRING  | Name der Datei auf dem Lizenz-Dongle  | 
sFilePathNameScr  | T_MaxString  | Pfadname der Datei auf der Festplatte  | 
pCopyBuff  | PVOID  | Buffer address for write  | 
cbCopyLen  | UDINT  | Count of bytes for write  | 
bExecute  | BOOL  | Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert.  | 
dwPassCode  | DWORD  | Passcode für den Dateizugriff  | 
tTimeout  | TIME  | Timeout-Zeit, die bei Ausführung des Befehls nicht überschritten werden darf.  | 
 Ausgänge
VAR_OUTPUT
    bBusy       :   BOOL;
    bError      :   BOOL;
    nErrorId    :   UDINT;
END_VARName  | Typ  | Beschreibung  | 
|---|---|---|
bBusy  | BOOL  | Bei der Aktivierung des Funktionsbausteins wird dieser Ausgang gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt.  | 
bError  | BOOL  | Sollte ein Fehler bei der Übertragung des Kommandos erfolgen, dann wird dieser Ausgang gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde.  | 
nErrorId  | UDINT  | Liefert bei einem gesetzten bError-Ausgang die ADS-Fehlernummer.  | 
Voraussetzungen
Entwicklungsumgebung  | Zielplattform  | Einzubindende SPS-Bibliotheken  | 
|---|---|---|
TwinCAT v3.1.4022  | PC oder CX (x64, x86)  | Tc2_Utilties >= 3.3.26.0  |