Programmierschnittstelle; Die Funktionen Der Dll; Brp_Open_Usb_Session - Siemens Simatic Ident Rf1060R Betriebsanleitung

Programmierschnittstelle

Allgemeine Informationen
Auf der Siemens-Supportseite "Industry Online Support
(https://support.industry.siemens.com/cs/ww/de/view/109741590)" erhalten Sie die Datei
"RF1060R.zip". Diese enthält Zugriffsfunktionen als DLL-Datei, sowie eine Demo-
Applikation, das die Verwendung der DLL-Datei veranschaulicht.
Mit der Demo-Applikation "AccessControlDemo" können Sie den RF1060R aus Ihrer
Applikation heraus über die USB-Schnittstelle direkt ansprechen. Eine vorkompilierte DLL-
Datei für Windows-Systeme, die diese Funktionalität bereitstellt, ist in dem Paket enthalten.
Die DLL-Datei stellt verschiedene Funktionen zur Kommunikation mit dem Reader für eine
Integration in Ihre Applikation bereit. Der Reader verfügt über Rückgabewerte und Status-
Codes, um Sie über den Reader-Status sowie die Durchführung der Funktionen zu
informieren.
4.1

Die Funktionen der DLL

4.1.1

brp_open_usb_session

Die Funktion öffnet über USB eine Verbindung zum Reader und gibt einen Sitzungsschlüssel
zurück, der für alle Funktionen und die weitere Kommunikation über diese Verbindung
benötigt wird. Wurde die Verbindung erfolgreich aufgebaut, wird der Rückgabewert
"BRP_OK" zurückgegeben.
Beachten Sie, dass alle nachfolgenden Funktionen erst dann durchgeführt werden können,
wenn sie mit der Funktion "brp_open_usb_session" eine Verbindung zu dem Reader
aufgebaut haben. Ist dies nicht der Fall, wird ein Fehler zurückgemeldet.
Hinweis
Parallelbetrieb nicht möglich
Beachten Sie, dass mit der Applikation nur zu einem einzelnen Reader zeitgleich eine
Verbindung aufgebaut werden kann. Aus diesem Grund darf "brp_open_session" immer nur
einmalig aufgerufen werden und muss vor einem erneuten Aufruf erst durch die Funktion
"brp_close_session" geschlossen werden.
Der Parameter "Handle" muss nach einem "brp_open_session" immer = "0" sein. Ist der
Parameter ≠ "0" liegt entweder ein Fehler vor oder die Funktion "brp_open_session" wurde
mehrmals hintereinander aufgerufen.
SIMATIC RF1060R
Betriebsanleitung, 05/2017, C79000-G8900-C432-02
4
13