GetSet_fil_size

c/c++pascal

BOOL [cd_]GetSet_fil_size([cdp_t cdp], t_oper operation, uns32 * size);
function [cd_]GetSet_fil_size([cdp : cdp_t]; operation : t_oper; var size uns32) : Boolean;

Parametry

operation - konstanta OPER_GET pro zjištění velikosti
  - konstanta OPER_SET pro nastavení velikosti.
size velikost databázového souboru v bajtech ( je výstupním parametrem při zjišťování velikosti, vstupním při nastavování)
[cdp kontextová proměnná klienta]

Od verze:

5.0

Popis

Funkce GetSet_fil_size slouží ke zjištění nebo zvětšení velikosti databázového souboru. Touto funkci nelze zmenšit velikost souboru. Funkci s hodnotou OPER_SET smí volat pouze provozní správce (CONFIG:ADMIN), jinak dojde k chybě NO_RIGHTS (129 - Nemáte právo provést tuto akci).

Používá se poté, co funkcí Get_server_info zjistíte malý počet volných clusterů databázového souboru nebo v aplikaci poté, co se při spuštění serveru (aplikací) objeví varovná hláška o nedostatku volných clusterů.

Obdobnou funkci GetSet_fil_blocks lze použít k témuž účelu, velikost se však zadává (a zjišťuje) nikoliv v bajtech, ale v blocích o velikosti 4 KB (obdobně jako z vývojového prostředí 602SQL).

Hodnota funkce

Vrátí TRUE při chybě, číslo chyby OS_FIL_ERROR (157), když není dost místa na disku. Při pokusu o zmenšení souboru funkce neudělá nic a vrátí FALSE.

Viz