CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Sonstige Variablentypen /

GetBin - Binärblock auslesen

CxiError CxiNode :: GetBin (CxiName pname, void *pbuffer, CxiShort *psize) const
CxiError cxiGetBin ...P (CxiHandle self, CxiName pname, void *pbuffer, CxiShort *psize)

Liest eine beliebige Variable

pname:
Name der Variablen oder Pfadangabe und Variablenname

pbuffer:
Gelesener Wert der Variablen, Inhalt bei Fehler unverändert

psize:
IN: Länge des Puffers
OUT: Gelesene Länge

return:
0 ok, sonst Fehler

Resource-Referenzen werden aufgelöst. Ist dies nicht möglich, wird ein Fehler zurückgegeben.

Ist die geforderte Variable nicht vorhanden, so wird der Fehler cxiErrorVarNotFound zurückgeliefert und *psize auf 0 gesetzt.

Ist pbuffer == NULL oder der Bereich zu klein für den Wert der Variablen, so wird *psize auf die erforderliche Größe gesetzt und der Code cxiErrorBufferTooSmall zurückgeliefert.

Die mindestens erforderliche Puffergröße kann für die Datentypen, bei denen die interne der externen Darstellung entspricht, auch mit QueryVarSize abgefragt werden. Bei den Typen cxiTypeBin, cxiTypeCar und cxiTypeEaS ist dies immer der Fall.

Binärvariablen (cxiTypeBin) werden bei Abspeicherung in Datei oder Übertragung innerhalb einer Message nicht konvertiert.

Diese Funktion führt keine Typprüfung durch. Alle Variablen können mit ihr ausgelesen werden. Zu beachten ist jedoch, dass alle Variablen im internen Format gelesen werden. Wichtig ist dies z.B. bei Stringlisten.

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

Siehe auch:
SetBin (mit Beispiel)
SetCar
GetCar
GetAsNum
GetAsStr