FC_BackupAllFiles

 

FC_BackupAllFiles - Allgemeine Informationen

Übersicht

Typ

Funktion

Verfügbar ab

SystemInterface_1.34.1.0

Verwendet von:

-

Versionen:

Aktuelle Version

Aufgabe

Sichern Sie die Daten der Flash-Disk der Steuerung auf einem USB-Speichergerät.

Beschreibung

Diese Funktion kopiert alle Daten der Steuerung auf ein USB-Speichergerät.

Die damit erstellte Sicherung kann dem Datenspeicher der Steuerung durch die Funktion FC_RestoreFiles wieder zur Verfügung gestellt werden.

Es kann ein absoluter Pfad mit dem Namen des USB-Geräts übergeben werden (z. B. "usb2msd:1/backup") oder nur der Pfad auf dem USB-Gerät ("/backup").

Das angeschlossene USB-Speichergerät wird automatisch für die Sicherung ausgewählt.

Als Gerät kann "usb2msd:0" (USB-Gerät ohne Partitionstabelle) oder "usb2msd:1" (USB-Gerät mit Partitionstabelle) gewählt werden.

Der Kopiervorgang wird begonnen, wenn auf dem Gerät genügend Speicherplatz zur Verfügung steht.

Wenn das Sicherungsverzeichnis schon vorhanden ist und Dateien enthält, wird der Inhalt gelöscht. Wenn Sie die Daten aufbewahren möchten, müssen Sie sie daher in ein anderes Verzeichnis verschieben, bevor Sie die Funktion ausführen.

Wird die Übertragung unterbrochen (z. B. beim Trennen des USB-Gerätes, bevor die Funktion beendet ist), muss der Kopiervorgang neu gestartet werden.

HINWEIS: Die Verzeichnisstruktur, mit Ausnahme des letzten Unterverzeichnisses, muss vorher angelegt werden: "usb2msd:0/Controller/Backup". Der Ordner "Controller" muss vorhanden sein, der Ordner "Backup" wird erstellt.

Die Übertragung kann mehrere Minuten dauern.

Schnittstelle

Eingang

Datentyp

Beschreibung

i_strBackupPath

STRING[1023]

Pfad für das Backup

Rückgabewert

Datentyp

Beschreibung

DINT

0: Kopieren war erfolgreich.

-1: -Fehler beim Kopieren (USB-Gerät getrennt).

-315: USB-Gerät wurde nicht gefunden. Prüfen Sie, ob die übergebene Gerätebezeichnung korrekt und das USB-Gerät mit der Steuerung verbunden ist.

-316: Nicht genügend Speicher auf dem Zielgerät.

-318: Ungültiger Pfad (Pfad auf Flash-Disk oder nicht existierender Pfad).

Beispiel

Anforderung

Der komplette Inhalt der Flash-Disk soll auf ein USB-Gerät gesichert werden.

Programm

diStatus := FC_BackupAllFiles('usb2msd:0/backup');
IF ( diStatus = 0 ) THEN
   //copy successful
END_IF  

Ergebnis

Wenn auf dem USB-Gerät genug Speicherplatz verfügbar ist, wird der komplette Inhalt der Flash-Disk der Steuerung in den Ordner "backup" auf dem USB-Gerät kopiert.

Vorhandene Dateien oder Unterordner in "/backup" werden gelöscht.