FC_BackupAllFiles - Allgemeine Informationen
Typ |
Funktion |
Verfügbar ab |
SystemInterface_1.34.1.0 |
Verwendet von: |
- |
Versionen: |
Aktuelle Version |
Sichern Sie die Daten der Flash-Disk der Steuerung auf einem USB-Speichergerät.
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.
Eingang |
Datentyp |
Beschreibung |
---|---|---|
i_strBackupPath |
STRING[1023] |
Pfad für das Backup |
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). |
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.