Vhl_Get_Snr - Siemens SIMATIC RF1000 Series Operating Instructions Manual

Parameter
Return value
6.2.1.9

vhl_get_snr

The function returns the serial number of the currently selected card. If the function
"vhl_select" could not be executed earlier or the card is no longer in the antenna field, the
value "CARD_NOT_SELECTED_ERR" (status code "0x0102") is returned. In this case, an
undefined serial number is returned. Note that the least significant byte of the serial number
is output first. For RF200/RF300 readers, the most significant byte is usually output first.
Function call
int
vhl_get_snr(
int Handle,
byte * Snr,
byte * Length,
int * Status
);
Table 6- 11
Parameter
vhl_get_snr
Return value
SIMATIC RF1000
Operating Instructions, 02/2019, C79000-G8976-C432-04
Description
Status
OK
•
NOTAG_ERR
•
HF_ERR
•
HW_ERR
•
CONFCARD_READ
•
You will find more information on the reader status in the section "Status
codes (Page 43)".
BRP_OK
•
You will find more information on return values in the section "Return val-
ues (Page 31)".
Description of the parameters
Description
The parameter returns the serial number of the currently selected card.
Handle The session key returned by the function "brp_open_usb_session".
Snr Serial number of the card (LSB first)
Length Length of the serial number in bytes
Status
OK
•
CARD_NOT_SELECTED_ERR
•
You will find more information on the reader status in the section "Status
codes (Page 43)".
BRP_OK
•
CARD_NOT_SELECTED_ERR
•
You will find more information on return values in the section "Return val-
ues (Page 31)".
Programming
6.2 Programming via USB interface
25