Zum Hauptinhalt springen

C16_BinInfo

C16_BinInfo(const vPHANDLE aHdl, const vBOOL aQueryPath, vC16_BinObj* aBinData) : vERROR​

Informationen eines binären Objektes / Verzeichnisses ermitteln

Details

  • aHdl: Deskriptor des binären Objetes / Verzeichnisses
  • aQueryPath: Eintrag FullName auch füllen
  • aBinData: Daten des gelesenen binären Objektes / Verzeichnisses
  • Resultat: vERROR Fehlerwert
  • Siehe: Befehle der Programmierschnittstelle , C16_BinOpen()

Mit dieser Funktion können Informationen eines binären Objektes bzw. Verzeichnisses ermittelt werden.

In (aHdl) wird der Deskriptor des binären Objektes bzw. Verzeichnisses angegeben.

Mit (aQueryPath) kann angegeben werden, ob auch der Eintrag FullName ermittelt wird. Dieser muss unter Umständen aus der Datenbank ermittelt werden. Alle anderen Daten stehen beim Lesen bereits im Speicher.

Falls (aData) nicht NULL ist, werden verschiedene Informationen zu dem binären Objekt bzw. Verzeichnis in einer Struktur zurückgegeben. 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

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