VldOpen
obj -> VldOpen(alpha1[, int2]) : handle
Validierungselement öffnen bzw. erstellen
Details
- obj: ValidierungvVerzeichnis
- alpha1: Elementname
- int2:
- Optionen (optional):
_VldLock_VldCreate
- Resultat:
handleÖffnungs-/Anlegeresultat Deskriptor des Validierungselementes oder_ErrVldNameInvalidElementname (alpha1) ungültig_ErrVldNoFileValidierungselement (alpha1) ist nicht vorhanden_ErrVldLockedValidierungselement (alpha1) ist gesperrt_ErrVldExistsIn einem zweiten Client wurde ein Validierungselement mit dem gleichen Namen angelegt und noch nicht mitVldClose ()geschlossen_rDeadlockVerklemmung aufgetreten - Siehe: Verwandte Befehle ,
VldClose (), Validierungselemente
Mit dieser Funktion wird ein Validierungselement geöffnet oder neu angelegt. In (obj) wird der Deskriptor des Validierungsverzeichnisses angegeben.
Die maximale Länge eines Validierungselementes beträgt 60 Zeichen. Der Name darf keine Steuerzeichen oder die Zeichen * und ? enthalten.
Folgende Optionen (int2) können angegeben werden:
_VldCreateDas Validierungselement wird im Validierungsverzeichnis erstellt._VldLockDas Validierungselement wird beim Öffnen oder Anlegen für andere Benutzer gesperrt.
Wird keine Sperroption angegeben, wird das Validierungselement mit einer gemeinsamen Sperre geöffnet.
Die Sperrung eines Validierungselementes bleibt bis zum Schließen des Objektes mit VldClose () oder bis sich der Benutzer von der Datenbank abmeldet erhalten. Änderungen an einem Validierungselement können nur bei einer exklusiven Sperre (siehe _VldLock) vorgenommen werden.
Beispiele:
// Objekt 'Frm_Main' im Verzeichnis tVldDir öffnen
tVldElm # tVldDir->VldOpen('Frm_Main');
// Objekt 'Frm_Sub' im Verzeichnis tDirHdl erstellen und für andere Benutzer sperren
tVldElm # tVldDir->VldOpen('Frm_Sub', _VldCreate | _VldLock);
Mögliche Laufzeitfehler:
_ErrHdlInvalid: Deskriptor des Validierungsverzeichnisses (obj) ist ungültig.