Vhl_Get_Snr; Vhl_Is_Selected - Siemens Simatic Ident Rf1060R Betriebsanleitung

Programmierschnittstelle
4.1 Die Funktionen der DLL
4.1.8

vhl_get_snr

Die Funktion gibt die Seriennummer der gerade ausgewählten Karte zurück. Wenn die
Funktion "vhl_select" zuvor nicht erfolgreich ausgeführt werden konnte oder die Karte nicht
mehr im Feld ist wird der Rückgabewert "CARD_NOT_SELECTED_ERR" (Status-Code
"0x0102") zurückgegeben. In diesem Fall wird eine undefinierte Seriennummer
zurückgegeben.
Funktionsaufruf
int
vhl_get_snr(
int Handle,
byte * Snr,
byte * Length,
int * Status
);
Beschreibung der Parameter
Parameter
vhl_get_snr
Rückgabewert
4.1.9

vhl_is_selected

Die Funktion überprüft, ob die bei der letzten Ausführung der Funktion "vhl_select"
ausgewählte Karte sich noch oder wieder im Antennenfeld befindet. Wenn die Karte
vorhanden ist, wird der Status "OK" zurückgegeben.
Beachten Sie, dass diese Funktion immer "CARD_NOT_SELECTED_ERR" zurückgibt, wenn
dem Reader eine Karte angezeigt wird, ohne dass zuvor die Funktion "vhl_select" ausgeführt
worden ist.
20
Beschreibung
Der Parameter gibt die Seriennummer der gerade ausgewählten Karte
zurück.
Handle Der von der Funktion "brp_open_usb_session()" zurückgelieferte Sitzungs-
schlüssel.
Snr Seriennummer der Karte
Length Länge der Seriennummer in Bytes
Status Weitere Informationen zu dem Reader-Status, finden Sie im Kapitel
"Status-Codes (Seite 22)".
BRP_OK
•
CARD_NOT_SELECTED_ERR
•
Weitere Informationen zu den Rückgabewerten, finden Sie im Kapitel
"Rückgabewerte (Seite 21)".
Betriebsanleitung, 05/2017, C79000-G8900-C432-02
SIMATIC RF1060R