Brp_Open_Usb_Session - Siemens Simatic Rf1000 Betriebsanleitung

7.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 7-1
Parameter
brp_open_usb_session
Rückgabewert
SIMATIC RF1000
Betriebsanleitung, 05/2023, C79000-G8900-C432-10
7.2 Programmierung über die USB-/RS232-Schnittstelle (über DLL-Funktionen)
Beschreibung der Parameter
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ück‐
gabewerte (Seite 53)".
Programmierung
35