Programmierschnittstelle; Die Funktionen Der Dll; Brp_Open_Usb_Session - Siemens Simatic 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
"RF10x0R.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 Reader 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.
5.1

Die Funktionen der DLL

5.1.1

brp_open_usb_session

Die Funktion öffnet über die USB-Schnittstelle 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/RF1070R
Betriebsanleitung, 10/2018, C79000-G8900-C432-03
5
13