Kill_user

C/C++Pascal

BOOL cd_Kill_user(cdp_t cdp, int client_number);
function cd_Kill_user(cdp : cdp_t; client_number : Integer) : Boolean;


Parametry

cdp
kontextová proměnná klienta
client_number
číslo klienta


Od verze

8.1

Popis

Funkce odpojí klienta s číslem client_number od serveru. Pokud klient s tímto číslem neexistuje, funkce neudělá nic. Přerušit dlouho trvající akci klienta (bez odpojení) lze provést funkcí Break_user.

Funkci může volat pouze provozní správce databáze.

Funkce neodpojí klienta (vlákno) čekajícího na semafor, na událost nebo ve funkci Sleep nebo sama sebe. V tom případě vrátí chybu. Ukončit pracovní vlákno může funkce Operation_limits.

Je-li klient odpojen uvnitř provádění transakce, provede se rollback transakce.

Číslo klienta lze zjistit například z výsledku dotazu _iv_logged_users nebo funkcí Client_number .



Návratová hodnota

Funkce vrací FALSE při úspěchu a TRUE při chybě.



Příklad

Pro odpojení uživatele 'David' nejprve zjistíme jeho číslo:
SELECT client_number FROM _iv_logged_users INTO :cli_num WHERE login_name='David'
a poté provozní správce zavolá funkci cd_Kill_user:
cd_Kill_user(cdp, cli_num);

Viz