<<

Contents

Search

>>

 

KILL_USER_ON_SERVER

 

 

Function

 

 

Syntax:

KILL_USER_ON_SERVER(<Protocol>,<Servername>,<Endpoint>,<User Number>,<Client Name>)

 

<Protocol>

= <STRING-EXPRESSION>

<Servername>

= <STRING-EXPRESSION>

<Endpoint>

= <STRING-EXPRESSION>

<User Number>

= <NUM-EXPRESSION>

<Client Name>

= <STRING-EXPRESSION>

 

 

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:

Protokol

These protocols are available:

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 or IP address of NT server.

 

Endpoint

Endpoint

 

User Number

User number in Ebus-C-Server

 

Client Name

Name of client in Ebus-C-Server

 

Sample:

NR% = GET_CLIENT_USER_NUMBER(CUSTOMER)

NAME$ = EBUS_CLIENT_NAME$

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

 

See also:

GET_CLIENT_USER_NUMBER

EBUS_CLIENT_NAME$

SERVER