Parametry
| uuid | identifikace objektu; |
| category | kategorie objektu; |
| position | výstupní parametr: číslo záznamu v systémové tabulce |
| [cdp | kontextová proměnná klienta] |
Změna ve verzi 8
Do verze 7 včetně byl typ výstupního parametru position dvoubajtový (označený zde Short). Typ tobjnum je nyní čtyřbajtový.
Popis
Funkce hledá databázový objekt kategorie category na základě jeho binární identifikace uuid. Dá se použít pro kategorie CATEG_USER, CATEG_GROUP.
Pokud objekt nalezne, vrátí v parametru position jeho číslo (tj. externí číslo záznamu v příslušné systémové tabulce.
Hodnota funkce
Funkce vrací při úspěchu FALSE a číslo objektu v position. Při chybě vrací TRUE. Typická chyba je OBJECT_NOT_FOUND - Objekt nenalezen. Doporučujeme vždy ověřovat výsledek této funkce, a tak se vyhnout pozdější práci s nesmyslným číslem objektu.
Viz