BinWriteMem

Mit dieser Funktion wird der komplette Inhalt des Memory-Objekts (handle1) in das binäre Objekt (obj) geschrieben. Ein bereits bestehender Inhalt wird dabei überschrieben. Das Objekt muss dazu exklusiv gesperrt sein (siehe _BinLock oder _BinSingleLock).

Optional kann der Inhalt durch übergabe einer der Stufen 1 bis 4 in (int2) komprimiert werden. Eine Kompressionsstufe 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.).

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

Das Resultat ist _ErrOk, wenn die Daten korrekt geschrieben werden konnten. Es können folgende Fehlerresultate auftreten:

• _ErrBinNoLock: Das binäre Objekt ist nicht exklusiv gesperrt.
• _ErrBinNoData: Das Memory-Objekt enthält keine Daten
• _rDeadlock: Verklemmung aufgetreten

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Der in (obj) oder (handle1) angegebene Desriptor ist ungültig.