Zum Hauptinhalt springen

C16_BinUpdate

C16_BinUpdate(const vPHANDLE aHdl, const vC16_BinObj* aBinData) : vERROR​

Änderungen an binären Objekt / Verzeichnis übernehmen

Details

Mit diesem Befehl werden Änderungen an den Eigenschaften eines Objektes oder eines Verzeichnisses in der Datenbank gespeichert. Das Objekt/Verzeichnis muss dazu exklusiv gesperrt sein (_BinLock bzw. _BinSingleLock).

Die geänderten Informationen müssen in (aData) in einer Struktur übergeben werden. Die Struktur ist folgendermaßen definiert:

typedef struct
{
  vXLONG  ID;
  vXLONG  StorageID;
  vCHAR   Name[64];
  vCHAR   FullName[512];
  vCHAR   Custom[256];

  vXLONG  Created;
  vXLONG  Modified;
  vXLONG  TimeExternal;

  vCHAR   CreatedUser[24];
  vCHAR   ModifiedUser[24];
  vCHAR   TypeUser[64];
  vCHAR   TypeMIME[64];

  vXLONG  SizeDba;
  vXLONG  SizeOrg;
  vBYTE   Compression;
}
vC16_BinObj;
  • Komponente: Beschreibung
  • ID: Identität des Objektes / Verzeichnisses
  • StorageID: Storage-ID (nur bei binären Objekten)
  • Name: Name des Objektes / Verzeichnisses
  • FullName: Pfad und Name des Objektes / Verzeichnisses (nur Verfügbar, wenn das Argument aQueryPath = TRUE ist)
  • Custom: Benutzerdefinierte Eigenschaft
  • Created: Erstellungszeitpunkt des Objektes
  • Modified: Zeitpunkt der letzten Änderung
  • TimeExternal: Datum und Uhrzeit der letzten Änderung der externen Datei vor Import
  • CreatedUser: Benutzer, der das Objekt erzeugt hat
  • ModifiedUser: Benutzer, der das Objekt zuletzt geändert hat
  • TypeUser: Benutzerdefinierte Typinformation
  • TypeMIME: MIME-Typ des Objektes
  • SizeDba: Speicherverbrauch des Objektes in der Datenbank
  • SizeOrg: Originalgröße des Objektes
  • Compression: Kompressionsstufe

Bei binären Verzeichnissen kann nur der Eintrag Custom verändert werden.

Bei binären Objekten können die folgenden Einträge verändert werden:

  • Custom
  • Created
  • Modified
  • TimeExternal
  • CreatedUser
  • ModifiedUser
  • TypeUser
  • TypeMIME

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

  • _rNoLock: Das Objekt / Verzeichnis ist nicht exklusiv gesperrt.
  • _rDeadlock: Verklemmung aufgetreten.