Get_property_value

C/C++PascalSQL

BOOL cd_Get_property_value(cdp_t cdp, const char * owner, const char * name, int num, char * buffer, unsigned buffer_size, int * valsize = NULL);
function cd_Get_property_value(cdp : cdp_t; owner, name : PChar; num : integer; buffer : PChar; buffer_size : integer; var valsize : integer) : Boolean;
function Get_property_value(IN owner CHAR(32), IN name CHAR(36), IN num INT); RETURNS CHAR(254);


Parametry

cdp
kontextová proměnná klienta
owner
majitel vlastnosti
name
jméno vlastnosti
num
číslo hodnoty vlastnosti
buffer
výstupní parametr: hodnota vlastnosti
buffer_size
velikost proměnné buffer v bajtech
valsize
výstupní parametr: velikost přečtené hodnoty v bajtech, nepoužívá se


Od verze

8.0

Popis

Funkce přečte hodnotu vlastnosti name majitele owner. Pokud vlastnost má více než jednu hodnotu (např. Dir1, Dir2), pak číslo hodnoty udává parametr num, v opačném případě musí mít parametr num hodnotu 0.

Funkce volaná klientem vrací hodnotu vlastnosti v řetězci buffer, funkce volaná v SQL ji vrací jako svoji hodnotu. Hodnota vlastnosti se vrací v podobě řetězce znaků. Pokud jde o vlastnost s číselnou hodnotou, parametr buffer obsahuje dekadický zápis hodnoty. Pokud zápis hodnoty je delší nebo roven buffer_size, je seříznut zprava tak, aby se vešel do proměnné buffer i s ukončující nulou.

V parametrech name a owner se nerozlišují velká a malá písmena.

Majitel vlastností SQL serveru se označuje řetězcem "@SQLSERVER".



Návratová hodnota

Funkce vrací na klientské straně FALSE při úspěchu a TRUE při chybě. V SQL funkce vrací hodnotu vlastnosti.

Viz