Vhl_Get_Snr - Siemens SIMATIC RF1060R Operating Instructions Manual

Description of the parameters
Parameter
vhl_select
Return value
4.1.8

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 field, the value
"CARD_NOT_SELECTED_ERR" (Status-Code "0x0102") is returned. In this case, an
undefined serial number is returned.
Function call
int
vhl_get_snr(
int Handle,
byte * Snr,
byte * Length,
int * Status
);
Description of the parameters
Parameter
vhl_get_snr
Return value
SIMATIC RF1060R
Operating Instructions, 05/2017, C79000-G8976-C432-02
Description
With this parameter you select a card located in the antenna field.
Handle The session key returned by the function "brp_open_usb_session()".
CardTypeMask The parameter specifies a card family to be recognized. If you want all card
families to be recognized, set the parameter to the value "0xFFFF".
Reselect The parameter decides whether the card should be reselected.
AllowConfig This value is always "false".
CardType The returned value indicates the card type.
Status You will find more information on the reader status in the section "Status
codes (Page 19)".
BRP_OK
•
You will find more information on return values in the section "Return val-
ues (Page 18)".
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
Length Length of the serial number in bytes
Status You will find more information on the reader status in the section "Status
codes (Page 19)".
BRP_OK
•
CARD_NOT_SELECTED_ERR
•
You will find more information on return values in the section "Return val-
ues (Page 18)".
Programming interface
4.1 The functions of the DLL
17