Insert_object

c/c++pascal

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

Parametry

name jméno objektu;
category kategorie objektu;
objnum vrácená hodnota: číslo objektu.
[cdp kontextová proměnná klienta]

Popis

Tato funkce vytvoří nový objekt zadané kategorie category a zadaného jména name. V parametru objnum vrátí číslo vytvořeného objektu. Objekt bude patřit do právě otevřené aplikace.

Parametr category musí být jedna z konstant CATEG_DOMAIN, CATEG_CURSOR, CATEG_PGMSRC, CATEG_APPL, CATEG_ROLE, CATEG_PROCEDURE, CATEG_TRIGGER, CATEG_DRAWING, CATEG_SEQUENCE.

Funkce vloží záznam s číslem objnum do systémové tabulky OBJTAB. Po zavolání funkce je třeba do sloupce proměnné délky DEFIN zapsat textovou definici objektu.

Pro vytvoření tabulky se použije SQL příkaz CREATE TABLE. Pro vytvoření pevného dotazu můžete použít SQL příkaz CREATE VIEW. Pro vytvoření uložené procedury nebo triggeru můžete použít SQL příkazy CREATE PROCEDURE nebo CREATE TRIGGER. Pro vytváření uživatele se použije funkce Create_user nebo SQL příkaz CREATE USER. Pro vytvoření skupiny uživatelů se používá funkce Create_group nebo SQL příkaz CREATE GROUP.

Má-li se objekt zařadit do jiného než základního folderu, přeuňte jej po vytvoření pomocí funkce Move_obj_to_folder.

Hodnota funkce

Funkce vrací při úspěchu FALSE, při neúspěchu TRUE.

Viz