KILL_USER_ON_SERVER
|
Syntax: |
KILL_USER_ON_SERVER(<Protocol>,<Servername>,<Endpoint>,<User
Number>,<Client Name>)
|
||||||||||||||||||||||||||||||
|
|
|
||||||||||||||||||||||||||||||
|
Meaning: |
Removes a user in Ebus-C-Server. Every client can disconnect an existing
connection to an Ebus-C-Server. In order to ensure clear identification the
<User number> and the <Client name> must be specified. The
<User number> is returned by the function GET_CLIENT_USER_NUMBER. The <Client name>
is saved in the variable EBUS_CLIENT_NAME$. KILL_USER_ON_SERVER should be applied
carefully. The function’s purpose is to disconnect an old, still existing
connection after a client has crashed, so that locked data records can be
unlocked on the Ebus-C-Server. If, e.g., on the Ebus-C-Server a time period
of 10 minutes is specified under settings, it takes at least 10
minutes until a crashed client is automatically disconnected and the locked
data records are unlocked. The function KILL_USER_ON_SERVER returns the result
0 if it has been successful, otherwise an error number. The error numbers are
listed in the file winerror.h in the Include directory of the C-Compilers. |
||||||||||||||||||||||||||||||
|
Parameter: |
|
||||||||||||||||||||||||||||||
|
Sample: |
NR% = GET_CLIENT_USER_NUMBER(CUSTOMER) NAME$ = EBUS_CLIENT_NAME$ H% = KILL_USER_ON_SERVER("ncacn_ip_tcp","Server1","",NR%,NAME$) |
||||||||||||||||||||||||||||||
|
See also: |
|