_bool := GETACCESS strExpression_Str [PUBLIC [descriptOUT_Str[, descriptIN_Str]]] |
| _bool | in | Identifikátor typu Bool. |
| strExpression_Str | in | Výraz typu String definujúci meno. |
| descriptOUT_Str | out | Výraz typu String - odkaz na hodnotu typu String. |
| descriptIN_Str | in | Identifikátor typu String - užívateľský popis k menu, použije sa pri úspešnej registrácii. |
Akcia registruje v rámci interpreta skriptu (procesu D2000 EventHandler alebo D2000 HI) alebo v rámci aplikácie (pri použití kľúčového slova PUBLIC) jednoznačné meno, ktoré je dané výrazom strExpression_Str. V prípade, že také meno existuje, vráti hodnotu @False. Ak neexistuje, vykoná registráciu a vráti úspech (hodnota @True). Ďalšie (iné) inštancie ľubovoľného eventu budú pri pokuse o registráciu zhodného mena (reťazca) neúspešné.
Registrované meno je viazané na inštanciu eventu (schémy) ktorá registráciu akciou GETACCESS realizovala. V prípade že inšancia zaniká (zatvorenie schémy, zatvorenie inštancie, ...), budú automaticky všetky registrované mená na ňu viazané odregistrované (akcia RELEASEACCESS).
Kľúčové slovo PUBLIC spôsobí, že registrované meno (reťazec) bude zverejnené pre všetky skripty (systémový event alebo aktívna schéma) v rámci aplikácie. Táto registrácia je zabezpečená prostredníctvom procesu D2000 Server.
Bez kľúčového slova PUBLIC je registrovaný reťazec známy len v rámci procesu v ktorom je skript interpretovaný (D2000 EventHandler alebo D2000 HI).
Po neúspešnej registrácii mena, bude parameter descriptOUT_Str obsahovať text identifikujúci skript, ktorý vykonal registráciu mena ako prvý. Formát textu je nasledovný:
computerName;processName;objectName;description
| computerName | Meno počítača, kde beží proces, ktorý vykonal registráciu. |
| processName | Meno objektu typu Proces, ktorý vykonal registráciu. |
| objectName | Meno objektu, ktorý vykonal registráciu (objekt typu Event alebo aktívna schéma). |
| description | Hodnota parametra descriptIN_Str akcie, ktorá vykonala úspešnú registráciu mena. |