C16_BinReadToMem

C16_BinReadToMem(const vPHANDLE aBinHdl, void* aMemAddress, const vXLONG aMemSize, const vCHAR* aCipherKey) : vERROR

Binäres Objekt exportieren

Details

• aBinHdl: Deskriptor des binären Objektes
• aMemAddress: Adresse des Zielspeicherbereiches
• aMemSize: Größe des Speicherbereiches
• aCipherKey: Verschlüsselungs-Code
• Resultat: vERROR Fehlerwert
• Siehe: Befehle der Programmierschnittstelle , C16_BinReadToFile() , C16_BinOpen() , C16_BinWriteFromMem()

Mit dieser Funktion wird der Inhalt des binären Objekts (aBinHdl) in den Speicherbereich (aMemAddress) eingelesen. Falls der Objektinhalt verschlüsselt gespeichert wurde, muss in (aCipherKey) der entsprechende Verschlüsselungscode angegeben werden. Bei einem inkorrekten Code ist das Resultat C16ERR_BIN_DECRYPTION. Falls das Objekt leer ist, wird C16ERR_BIN_NO_DATA zurückgeliefert. In allen anderen Fällen ist das Resultat C16ERR_OK.

info

Der Speicherbereich muss mindestens so groß sein, wie das binäre Objekt in entpackter Form (siehe SizeOrg ).

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler), einen negativen Fehlerwert (siehe Fehlerwerte ) oder einen der folgenden Fehlerwerte:

• C16ERR_BIN_DECRYPTION: Verschlüsselungs-Code ist falsch.
• C16ERR_BIN_NO_DATA: Binäres Objekt ist leer.
• C16ERR_BIN_DATA_ERR: Allgemeiner Fehler.

Beispiel:

// Binäres Objekt öffnen
vPHANDLE tBinHdl;
tErr = C16_BinOpen(tInstHdl, tDirHdl, "Content.txt", 0, &tBinHdl);
if (tErr == C16ERR_OK)
{
  // Daten des binären Objektes ermitteln
  vC16_BinObj tBinData;
  C16_BinInfo(tBinHdl, false, &tBinData);

  // Daten in den Speicherbereich schreiben
  vBYTE* tMemory = new vBYTE[tBinData.SizeOrg];
  tErr = C16_BinReadToMem(tBinHdl, tMemory, tBinData.SizeOrg, NULL);
  // Fehlerbehandlung und weitere Verarbeitung
  // ...

  // Binäres Objekt schließen
  C16_BinClose(tBinHdl);
}