CXI-Basis-Programmierreferenz / Version 2 / Datenspeicherung / CxiNode / Statusabfragen /

ChangeAccess - Zugriffsschutz definieren

CxiError CxiNode :: ChangeAccess (CxiShort accmode)
CxiError cxiChangeAccess (CxiHandle self, CxiShort accmode)

Sperrt oder erlaubt Veränderungen des Blocks

accmode:
cxiOptReadWrite: Block darf verändert werden
cxiOptReadOnly: Block darf nicht verändert werden, Sperre kann wieder aufgehoben werden
cxiOptReadOnlyLock: Block darf nicht verändert werden, Sperre kann nicht aufgehoben werden

return:
0 ok, sonst Fehler

Ist der Block das Sichtfenster eines CXI-Baums, so bezieht sich diese Einstellung auf den gesamten Baum. Wird versucht, auf einen mit cxiOptReadOnly geschützten Block mit einer Set...-Funktion zuzugreifen, so liefert diese den Fehler cxiErrorReadOnly zurück und lässt den Block unverändert. Auf einen schreibgeschützten Block können nur diejenigen Funktionen angewendet werden, die in der C++-Schnittstelle mit dem Schlüsselwort const nach dem Funktionskopf gekennzeichnet sind.

Wurde einmal für einen Block eine Sperre mittels cxiOptReadOnlyLock gesetzt, so kann diese Sperre nicht wieder aufgehoben werden, sie gilt bis zum Freigeben des Objekts. Einige Klassen setzen automatisch cxiOptReadOnlyLock. ChangeAccess liefert für einen derart geschützten Block immer cxiErrorAccessLocked zurück.

Die Konstante cxiOptReadOnlyLock ist identisch zu cxiOptReadOnly | cxiOptAccessLock.

WICHTIG: CXI-Knoten, die über das Meldungssystem Stufe 1 verschickt werden sollen, dürfen nicht schreibgeschützt werden, da das Meldungssystem interne Steuervariablen und den Rückgabewert in den Block eintragen muss. Das erweiterte Meldungssystem Stufe 2 besitzt diese Einschränkung nicht.

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

Siehe auch:
QueryAccess
QueryDirty
IsDirty