FC_BackupAllFiles – Allgemeine Informationen

Überblick

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.

Sie können diese Sicherung mit FC_RestoreFiles wieder im Datenspeicher der Steuerung zur Verfügung stellen.

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

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

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 erstellt werden: "/usb2msd16a/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: Der Kopiervorgang war erfolgreich. -1: Fehler beim Kopieren erkannt (USB-Gerät getrennt) -315: Das 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 Arbeitsspeicher auf dem Zielgerät verfügbar -318: Ungültiger Pfad (Pfad auf Flash-Disk oder nicht vorhandener Pfad)

Datentyp

Beschreibung

DINT

0: Der Kopiervorgang war erfolgreich.

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

-315: Das 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 Arbeitsspeicher auf dem Zielgerät verfügbar

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

Beispiel

Anforderung

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

Programm

diStatus := FC_BackupAllFiles('/usb2msd16a/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.