CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiTree / Ableitung CxiTreeFile /

NewBor - Erstellen eines Binärobjekts

CxiError CxiTreeFile :: NewBor (CxiName pname, CxiLong psize)
CxiError cxiNewBor (CxiHandle self, CxiName pname, CxiLong psize, CxiLong reserved)

Erstellt ein Binärobjekt und die dazugehörige Binärobjektreferenz (BOR)

pname:
Name der Variablen

psize:
Größe des Binärobjekts

reserved:
Reserveparameter, muss 0 sein

return:
0 ok, sonst Fehler

Ein Binärobjekt ist im Gegensatz zu einer Binärvariablen nicht direkt im Sichtfenster abgelegt. Dort findet sich lediglich ein internes Handle zum Auffinden der Daten in der CXI-Datei. Binärobjekte können daher nur in CxiTreeFile-Objekten vorkommen. Durch die Auslagerung aus dem Sichtfenster sind Binärobjekte nur durch die Größe des freien Platzes auf dem Datenträger beschränkt, nicht durch cxiMaxSize.

Der Zugriff auf Binärobjekte ähnelt dem Zugriff auf Dateien. Mit den Lese- und Schreibfunktionen können ganze Binärobjekte oder Teile davon übertragen werden.

Portabilität:
Diese Funktion ist in allen unterstützten Systemen verfügbar.

Siehe auch:
CxiTreeFile(...)
ReadBor - Lesen eines Binärobjekts
WriteBor - Schreiben eines Binärobjekts
CopyBor - Kopieren eines Binärobjekts