FC_CheckProgramIdent

FC_CheckProgramIdent – Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab:	SystemInterface_1.32.6.0
Versionen:	Aktuelle Version

Aufgabe

Vor dem Laden eines Speicherabbilds (Retainimage) überprüfen, ob das Speicherabbild zur Applikation passt

Beschreibung

Die Funktion liest die ProgramIdent des Speicherabbilds aus der angegebenen Datei und vergleicht sie mit der ProgramIdent der Anwendung, die derzeit im Speicher geladen ist.

HINWEIS: Die typische Laufzeit der Funktion auf einer Steuerung, wenn sich die Retaindatendatei auf dem Laufwerk "ide0:" befindet, beträgt 50 ms.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_sRetainImageFileName	STRING[80]	Name der Datei, deren ProgramIdent mit der ProgramIdent des Programms verglichen wird, das derzeit im Hauptspeicher geladen ist. Der Dateiname erhält automatisch die Endung ".ret". Die Datei kann sich in einem beliebigen Verzeichnis der Steuerung befinden. Es sind keine Sonderzeichen oder Platzhalter im Dateinamen erlaubt.

Rückgabewert

Datentyp	Beschreibung
DINT	0: Die ProgramIdent des Programms und des Speicherabbilds stimmen überein. -1: Die ProgramIdent konnte nicht verglichen werden, da ein ungültiger Dateiname übertragen wurde. Der Dateiname enthält Sonderzeichen ":", "\" oder "/" und Platzhalter "*" oder "?". -2: Die zusätzlichen Informationen konnten nicht gelesen werden, weil das angegebene Verzeichnis nicht existiert. -3: Die ProgramIdent konnte nicht verglichen werden, weil der angegebene Dateiname nicht existiert. -4: Die ProgramIdent des Programms und des Speicherabbilds stimmen nicht überein. -5: Die ProgramIdent konnte nicht verglichen werden, weil die angegebene Datei keine Retainimagedatei eines Retainspeichers ist. -6: Die ProgramIdent konnte nicht verglichen werden, weil die angegebene Datei kein Speicherabbild des Retainspeichers enthält.

Datentyp

Beschreibung

DINT

0: Die ProgramIdent des Programms und des Speicherabbilds stimmen überein.

-1: Die ProgramIdent konnte nicht verglichen werden, da ein ungültiger Dateiname übertragen wurde. Der Dateiname enthält Sonderzeichen ":", "\" oder "/" und Platzhalter "*" oder "?".

-2: Die zusätzlichen Informationen konnten nicht gelesen werden, weil das angegebene Verzeichnis nicht existiert.

-3: Die ProgramIdent konnte nicht verglichen werden, weil der angegebene Dateiname nicht existiert.

-4: Die ProgramIdent des Programms und des Speicherabbilds stimmen nicht überein.

-5: Die ProgramIdent konnte nicht verglichen werden, weil die angegebene Datei keine Retainimagedatei eines Retainspeichers ist.

-6: Die ProgramIdent konnte nicht verglichen werden, weil die angegebene Datei kein Speicherabbild des Retainspeichers enthält.

Beispiele

diResult := FC_CheckProgramIdent(‚karton');

Die ProgramIdent der Applikation wird mit der in der Datei "karton.ret" gespeicherten ProgramIdent verglichen. Die Datei "karton.ret" befindet sich auf dem Standardgerät "ide0:".

diResult := FC_CheckProgramIdent(‚ide0:\retain\plister');

Die ProgramIdent der Applikation wird mit der in der Datei "plister.ret" gespeicherten ProgramIdent verglichen. Die Datei "plister.ret" befindet sich im Verzeichnis "retain" auf dem Standardgerät "ide0:".

diResult := FC_CheckProgramIdent('remote:ide0:\etikett');

Die ProgramIdent der Applikation wird mit der in der Datei "etikett.ret" gespeicherten ProgramIdent verglichen. Die Datei "etikettt.ret" befindet sich auf dem Remote-Gerät "remote:" im Laufwerk "ide0:".