Relist_objects

c/c++pascal

BOOL [cd_]Relist_objects([cdp_t cdp]);
function [cd_]Relist_objects([cdp : cdp_t]) : Boolean;

Parametry

[cdp kontextová proměnná klienta]

Popis

Funkce zajistí, že v popisu aplikace na řídicím panelu budou aktuální objekty. K nesouladu mezi současným stavem a stavem po otevření aplikace (signalizovaném na řídicím panelu) může dojít tehdy, provedete-li z programu funkci SQL_execute s parametrem CREATE ... (TABLE, DOMAIN, VIEW, PROCEDURE, TRIGGER, USER, GROUP, ROLE) nebo DROP (TABLE, DOMAIN, VIEW, PROCEDURE, TRIGGER, USER, GROUP, ROLE). Pak vznikne nebo zanikne objekt, aniž by se o tom dověděl řídicí panel aplikace. Proto takto vytvořený objekt by po doběhnutí programu na panelu scházel a zrušený objekt by se na něm naopak nacházel.

Tomuto nekonzistentnímu stavu zabráníte tím, že zavoláte funkcí Relist_objects. Tato funkce zjistí momentální seznam objektů patřících k aplikaci a aktualizuje obsah řídicího panelu.

Při interaktivním způsobu práce ve vývojovém prostředí může k tomuto stavu dojít jedině tak, když jsou objekty vytvářeny SQL příkazy pomocí SQL konzole. Na liště a v menu je proto obdobná akce Obnovit objekty.

Hodnota funkce

Funkce při chybě vrátí TRUE, při úspěchu FALSE.

Viz