BinWriteMem

obj -> BinWriteMem(handle1[, int2[, alpha3]]) : int

Binäres Objekt aus Memory-Objekt schreiben

Details

• obj: Deskriptor eines binären Objekts
• handle1: Deskriptor eines Memory-Objekts
• int2: Kompressionsstufe (optional)
• alpha3: Verschlüsselungs-Code (optional)
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , BinReadMem ()

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.