GetSet_fil_blocks

c/c++pascal

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

Parametry

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

Od verze

6.0

Popis

Funkce GetSet_fil_blocks 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_size lze použít k témuž účelu, velikost se však zadává (a zjišťuje) nikoliv v blocích 4 KB, ale přímo v bajtech.

Hodnota funkce

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

Viz