C16_BinWriteFromMem

Mit dieser Funktion wird der komplette Inhalt des Speicherbereichs (aMemAddress/aMemSize) in das binäre Objekt (aBinHdl) importiert. Ein bereits bestehender Inhalt wird dabei überschrieben. Das Objekt muss dazu exklusiv gesperrt sein (_BinLock bzw. _BinSingleLock). Der Speicherbereich 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: Der Speicherbereich ist leer.