C16_BinWriteFromFile

Mit dieser Funktion wird der Inhalt der externen Datei (aFilename) in das Objekt (aBinHdl) importiert. Ein bereits bestehender Inhalt wird dabei überschrieben. Das Objekt muss dazu exklusiv gesperrt sein (_BinLock bzw. _BinSingleLock). Die externe Datei darf nicht leer sein.

Das Objekt kann mit einer symmetrischen Verschlüsselung gespeichert werden. Dazu wird ein entsprechender Verschlüsselungscode mit bis zu 64 Zeichen in (aCipherKey) übergeben (siehe ``StrEncrypt()). Es ist zu beachten, dass ohne diesen Code der Objektinhalt nicht mehr gelesen werden kann.

Der Inhalt kann mit den Stufen 1 bis 4 komprimiert werden. Eine Kompressionsstufe (aCompression) sollte nicht bei Dateien angegeben werden, die sich nicht weiter komprimieren lassen. Dazu gehören vor allem gepackte Dateiformate (.zip,.rar usw.) und komprimierte Multimedia-Formate (.jpg,.mov,.mp3 usw.).

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler), einen negativen Fehlerwert (siehe Fehlerwerte) oder einen der folgenden Fehlerwerte:

• _rNoLock: Binäres Objekt (aBinHdl) ist nicht exklusiv gesperrt.
• _rDeadlock: Verklemmung aufgetreten.
• C16ERR_BIN_NO_DATA: Externe Datei (aFilename) ist leer.
• C16ERR_FSI_NO_PATH: Pfad im Namen der externe Datei (aFilename) nicht vorhanden.
• C16ERR_FSI_NO_PATH: Datei im Namen der externe Datei (aFilename) nicht vorhanden.
• C16ERR_FSI_TOO_MANY_OPEN: Maximale Anzahl offener Dateien erreicht.
• C16ERR_FSI_ACCESS_DENIED: Zugriff auf externe Datei (aFilename) verweigert.
• C16ERR_FSI_INVALID_HANDLE: Datei-Deskriptor von externer Datei (aFilename) ungültig.
• C16ERR_FSI_INVALID_DRIVE: Laufwerk im Namen der externen Datei (aFilename) ungültig.
• C16ERR_FSI_SHARING_VIOLATION: Zugriffskonflikt bei Zugriff auf externe Datei (aFilename).
• C16ERR_FSI_LOCK_VIOLATION: Sperrkonflikt bei Zugriff auf externe Datei (aFilename).
• C16ERR_FSI_OPEN_FAILED: Externe Datei (aFilename) konnte nicht geöffnet werden.