Vhl_Is_Selected; Vhl_Read - Siemens SIMATIC RF1040R Operating Instructions Manual

Programming
6.2 Programming via USB interface
6.2.1.10

vhl_is_selected

This function checks whether the card selected the last time the "vhl_select" function was
executed is still or once again located in the antenna field. If the card is there, the status
"OK" is returned.
Note that this function always returns the return value "CARD_NOT_SELECTED_ERR"
when a card is displayed to the reader without the "vhl_select" function being executed first.
Function call
int
vhl_is_selected(
int Handle,
int * Status
);
Table 6- 12
Parameter
vhl_is_selected
Return value
6.2.1.11

vhl_read

This function reads the memory area that is stored in a VHL file previously stored in the
reader. The VHL configuration stored in the reader is referenced with the "VHLFile ID".
When a card is located in the antenna field and the function was completed, the status "OK"
is returned.
Note that this function always returns the return value "CARD_NOT_SELECTED_ERR"
when a card is displayed to the reader without the "vhl_select" function being executed first.
30
Description of the parameters
Description
The parameter checks whether the card selected the last time the
"vhl_select" function was executed is still or once again located in the an-
tenna field.
Handle The session key returned by the function "brp_open_usb_session".
Status
OK
•
CARD_NOT_SELECTED_ERR
•
You will find more information on the reader status in the section "Status
codes (Page 48)".
BRP_OK
•
You will find more information on return values in the section "Return val-
ues (Page 35)".
Operating Instructions, 11/2019, C79000-G8976-C432-06
SIMATIC RF1000