Find_object

c/c++pascal

BOOL [cd_]Find_object([cdp_t cdp], const char * name, tcateg category, tobjnum *position);
function [cd_]Find_object([cdp : cdp_t]; name : PChar; category : tcateg; var position : tobjnum) : Boolean;

Parametry

name jméno objektu;
category kategorie objektu;
position výstupní parametr: číslo záznamu v systémové tabulce
[cdp kontextová proměnná klienta]

Popis

Funkce zjistí, zda existuje v otevřené aplikaci objekt jména name a kategorie category. Pokud ano, 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_....

Funkci lze použít i na vyhledání objektu typu uživatel nebo skupina (CATEG_USER, CATEG_GROUP), které nepatří do žádné aplikace.

Hodnota funkce

Funkce vrací při úspěchu FALSE, při neúspěchu 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