Zum Hauptinhalt springen

C16_BinWriteFromFile

C16_BinWriteFromFile(const vPHANDLE aBinHdl, const vCHAR* aFilename, const vCHAR* aCipherKey, const vBYTE aCompression) : vERROR​

Binäres Objekt importieren

Details

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.