<<

Inhaltsverzeichnis

Suchen

>>

 

KILL_USER_ON_SERVER

 

 

Funktion

 

 

Syntax:

KILL_USER_ON_SERVER(<Protokoll>,<Servername>,<Endpoint>,<Usernummer>,<Clientname>)

 

<Protokoll>

= <STRING-AUSDRUCK>

<Servername>

= <STRING-AUSDRUCK>

<Endpoint>

= <STRING-AUSDRUCK>

<Usernummer>

= <NUM-AUSDRUCK>

<Clientname>

= <STRING-AUSDRUCK>

 

 

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:

Protokoll

Folgende Protokolle sind zulässig:

ncacn_ip_tcp

Connection-oriented TCP over IP

ncacn_nb_tcp

Connection-oriented TCP over NetBIOS

ncacn_nb_ipx

Connection-oriented IPX over NetBEUI

ncacn_nb_nb

Connection-oriented NetBIOS over NetBEUI

ncacn_np

Connection-oriented named pipes

ncacn_spx

Connection-oriented SPX

ncacn_dnet_nsp

Connection-oriented DECnet transport

ncadg_ip_udp

Datagram (connectionless) UDP over IP

ncadg_ipx

Datagram (connectionless) IPX

ncalrpc

Local (cross-process) procedure call

 

Servername

Name oder IP-Adresse des NT-Servers.

 

Endpoint

Endpoint

 

Usernummer

Nummer des Users im Ebus-C-Server

 

Clientname

Name des Clients im Ebus-C-Server

 

Beispiel:

NR% = GET_CLIENT_USER_NUMBER(KUNDEN)

NAME$ = EBUS_CLIENT_NAME$

H% = KILL_USER_ON_SERVER("ncacn_ip_tcp","Server1","",NR%,NAME$)

 

Siehe auch:

GET_CLIENT_USER_NUMBER

EBUS_CLIENT_NAME$

SERVER