Funkce GetSet_group

GetSet_group_role

BOOL [cd_]GetSet_group_role([cdp_t cdp], tobjnum user_or_group, tobjnum group_or_role, tcateg subject2, t_oper operation, uns32 * relation);
function [cd_]GetSet_group_role([cdp : cdp_t]; user_or_group, group_or_role : tobjnum; subject2 : tcateg; operation : t_oper, var relation : uns32) : Boolean;

Parametry

user_or_group	číslo uživatele nebo skupiny
group_or_role	číslo skupiny nebo role
subject2	udává význam parametru group_or_role, nabývá hodnot `CATEG_GROUP` nebo `CATEG_ROLE`
operation	- konstanta `OPER_SET` (zařazení / vyřazení)
	- konstanta `OPER_GET` (resp. `OPER_GETEFF`) (zjištění stavu)
relation	- 1= zařadí / zařazeno
	- 0=vyřadí / vyřazeno
[cdp	kontextová proměnná klienta]

Od verze:

5.0

Popis

Je-li operation rovno OPER_SET, funkce GetSet_group_role zařazuje (relation =1) nebo vyřazuje (relation = 0) uživatele nebo skupinu user_or_group do/ze skupiny nebo role group_or_role.

Pro operation rovno OPER_GET funkce GetSet_group_role zjišťuje stav nalezení uživatele nebo skupiny user_or_group ve skupině nebo roli group_or_role a vrací hodnotu ve výstupním parametru relation. (relation =1 zařazeno a relation = 0 vyřazeno). Pro role je možné zjišťovat i efektivní náležení uživatele do role - pomocí operation rovno OPER_GETEFF.

Číslo subjektu práv vrátí funkce Find_object.

Zařazovat uživatele do skupiny smí pouze bezpečnostní a provozní správce databáze. Obsazovat uživatele nebo skupinu do role smí správce správce aplikace. Jinak dojde k chybě NO_RIGHT (Nemáte právo provést tuto akci).

Funkce nahrazuje starší funkce User_in_group a User_to_group.

V jazyce SQL je obdobná dvojice funkcí Set_membership a Get_membership.

Hodnota funkce

Funkce vrací TRUE při chybě.

Viz