Parametry
| name | jméno objektu; |
| appl_id | identifikace aplikace; |
| category | kategorie objektu; |
| position | výstupní parametr: číslo záznamu v systémové tabulce |
| [cdp | kontextová proměnná klienta] |
Popis
Funkce Find2_object hledá object kategorie category jménem name v aplikaci jejíž identifikace je v appl_id. Pokud ho nalezne, vrátí v parametru position jeho číslo (tj. externí číslo záznamu v příslušné systémové tabulce - TABTAB pro tabulky, OBJTAB pro ostatní objekty, USERTAB pro uživatele a skupiny).
Jako parametr category se používají konstanty CATEG_....
Pokud name označuje spojovací objekt, pak funkce dokáže vrátit buď číslo spojovacího objektu, nebo rovnou číslo objektu, který je tímto spojovacím objektem připojen. Je-li parametrem category sjednocení konstanty označující kategorii s konstantou IS_LINK, pak funkce vrátí ve výstupním parametru position číslo spojovacího objektu. Pokud neuvedete IS_LINK, pak funkce vrací číslo připojeného objektu.
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