Find2_object

C/C++Pascal

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

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_TABLE, CATEG_VIEW, CATEG_CURSOR, CATEG_MENU, CATEG_PGMSRC, CATEG_PGMEXE, CATEG_USER, CATEG_APPL, CATEG_PICT, CATEG_GROUP, CATEG_ROLE, CATEG_CONNECTION, CATEG_RELATION, CATEG_DRAWING, CATEG_GRAPH, CATEG_REPLREL, p°φpadn∞ sjednocenΘ s konstantou IS_LINK.

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