KILL_USER_ON_SERVER
|
Syntax: |
KILL_USER_ON_SERVER(<Protokoll>,<Servername>,<Endpoint>,<Usernummer>,<Clientname>)
|
||||||||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||||||||
|
Bedeutung: |
Löscht
einen User im Ebus-C-Server. Jeder
Client kann eine noch bestehende Verbindung zu einem Ebus-C-Server trennen.
Zur eindeutigen Identifizierung müssen die <Usernummer> und der <Clientname>
angegeben werden. Die <Usernummer> wird von der Funktion GET_CLIENT_USER_NUMBER geliefert.
Der <Clientname> ist in der Variablen EBUS_CLIENT_NAME$ gespeichert. KILL_USER_ON_SERVER
sollte mit Vorsicht angewendet werden. Diese Funktion ist dazu gedacht, nach
einem Client-Absturz eine alte noch bestehende Verbindung zu trennen, damit
eventuell noch gesperrte Datensätze auf dem Ebus-C-Server freigegeben werden
können. Wenn z.B. auf dem Ebus-C-Server unter Einstellungen eine
Zeitspanne von 10 Minuten festgelegt ist, so dauert es mindestens 10 Minuten,
bis ein abgestürzter Client automatisch getrennt wird und damit die
gesperrten Datensätze freigegeben werden. Die Funktion
KILL_USER_ON_SERVER liefert als Ergebnis 0, wenn sie erfolgreich war,
andernfalls eine Fehlernummer. Die Fehlernummern sind in der Datei winerror.h
im Include-Verzeichnis des C-Compilers aufgelistet. |
||||||||||||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||||||||||||
|
Beispiel: |
NR% = GET_CLIENT_USER_NUMBER(KUNDEN) NAME$ = EBUS_CLIENT_NAME$ H% = KILL_USER_ON_SERVER("ncacn_ip_tcp","Server1","",NR%,NAME$) |
||||||||||||||||||||||||||||||
|
Siehe auch: |
|