Brp_Open_Usb_Session - Siemens SIMATIC RF1000 Betriebsanleitung

6.2.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, beim Betrieb über die USB-Schnittstelle,
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_usb_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_usb_session" immer = "0" sein. Ist der
Parameter ≠ "0" liegt entweder ein Fehler vor oder die Funktion "brp_open_usb_session"
wurde mehrmals hintereinander aufgerufen.
Funktionsaufruf
int
brp_open_usb_session(
int * Handle,
DWORD ProductID
);
Tabelle 6- 1 Beschreibung der Parameter
Parameter
brp_open_usb_session
Rückgabewert
SIMATIC RF1000
Betriebsanleitung, 02/2020, C79000-G8900-C432-07
6.2 Programmierung über die USB-/RS232-Schnittstelle (über DLL-Funktionen)
Beschreibung
Dieser Funktionsaufruf öffnet über die USB-Schnittstelle eine Verbindung
zum Reader.
Handle Sitzungsschlüssel der von dieser Funktion initialisiert wird. Der Schlüssel ist
gültig, sobald "BRP_OK" zurückgeliefert wird.
ProductID 0x00
BRP_OK
•
BRP_ERR_BUSY
•
BRP_ERR_GENERAL_IO
•
BRP_ERR_BUFFER_OVERFLOW
•
BRP_ERR_NO_MORE_HANDLES
•
BRP_ERR_INSUFFICIENT_MEM
•
Weitere Informationen zu den Rückgabewerten, finden Sie im Kapitel
"Rückgabewerte (Seite 43)".
Programmierung
25