C16_BinWriteFromMem
C16_BinWriteFromMem(const vPHANDLE aBinHdl, void* aMemAddress, const, vXLONG aMemSize, const vCHAR* aCipherKey, const vBYTE aCompression) : vERROR
Binäres Objekt importieren
Details
- aBinHdl: Deskriptor des binären Objektes
- aMemAddress: Adresse des Quellspeicherbereichs
- aMemSize: Größe des Speicherbereichs
- aCipherKey: Verschlüsselungs-Code
- aCompression: Kompressionsstufe
- Resultat: vERROR Fehlerwert
- Siehe: Befehle der Programmierschnittstelle , C16_BinWriteFromFile() , C16_BinOpen() , C16_BinReadToMem()
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.