4Links EtherSpaceLink Series, Руководство пользователя

Страница: 84 / 110

EtherSpaceLink-RG408
EtherSpaceLink family User Manual
14. 6 . 23 .
EtherSpaceLink_get_product_string()
S ynops i s
char * EtherSpaceLink_get_product_string ( EtherSpaceLink ESL_unit
)
D esc ri pt i on
EtherSpaceLink_get_manufacturer_string()
r et u r ns a n A S C II st ri n g i nd i ca t i n g t h e
p
r
o
d
u c
t n
a
me.
Th
i s st ri n g i s e x t r
ac
ted
f
r
o
m t
h
e U n i
c o
de st ri n g
ac
t
u a lly
r et
u
r ned b
y
t
h
e
u
n i t , b
y
e x t r ac t i n g t h e l e a st s ig n i f i ca nt 8 - b i ts o f e ach cha r ac te r .
I nput p ara mete r s
ESL_unit
t h e ha nd l e r et u r ned b y a s u cc ess f ul
EtherSpaceLink_open()
c o mm a nd.
Retu r ns
char *
Th
i s i s
a po
i nte r t
o
t
h
e mem
o
r
y a
r e
a c o
nt
a
i n i n g
a z
e r
o -
te r m i n
a
ted st ri n g
o f
8
-
b i t
cha r ac te r s. A n ull po i nte r ( 0) i s r et u r ned i f a n e rr o r o cc u rr ed w h i l e o bt a i n i n g t h e
d
a
t
a
.
Note
B
e
a w a
r e t
ha
t
EtherSpaceLink_get_product_string()
s
h oul
d
o
n
ly
be
ca ll
ed
a
t t
h
e st
a
r t
o f
a n A P I p r o gr a m , be f o r e t h e S p ac e W ir e l i n k (s ) a r e en a b l ed. S ee se c t i o n 1 4 . 5 .3 , “ A s y n ch r o n ou s Iss u es
d
u
ri n g S t
a
t
u
s
Poll
i n g
”
,
E xa mple
EtherSpaceLink ESL_unit;
ESL_unit = EtherSpaceLink_open ( "192.168.3.40" );
printf( "%s", EtherSpaceLink_get_product_string ( ESL_unit ) );
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 84 of 110
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park