ue_disconnect

Description

Defines what actions are to be performed prior to a client disconnecting from TRS.

Syntax

TRS_RETCODE TRS_PUBLIC
ue_disconnect (status, serviceName, serviceNameLength, applicationName, applicationNameLength, userId, pUserIdLength)

TRS_STATUS	status;
const char*	serviceName;
const int	serviceNameLength;
const char*	applicationName;
const int	applicationNameLength
ccnst char*	userId;
int*	pUserIdLength;

**Table D-3: TRS_RETCODE values**
Value	Description
eTRS_FAIL	Indicates failure within ue_disconnect( )
eTRS_SUCCEED	Indicates success within ue_disconnect( )
eTRS_NOTIMPLEMENTED	Indicates stubbed out implementation of ue_disconnect( )

Parameters

status

The state of the Service Library invoking ue_disconnect( ). Table D-4 describes the legal value for status:

**Table D-4: Legal status values**
Value	Description
eGood_	Always used
eObjNotFound_	Reserved for future use
eObjNotValue_	Reserved f or future use
eFatal_	Reserved for future use

serviceName: Name of the service to which the connection was made.

serviceNameLength: Length of the serviceName.

applicationName: Name of the application from which the connection was made.

applicationNameLength: Length of the applicationName.

userId: ID of the connecting user.

pUserIdLength: Pointer to length of userId.

Usage

See syntax.

Comments

ue_disconnect allows you to perform varying functions related to disconnects. Although pUserIdLength is defined as a pointer, its modification is meaningless with this release.

WARNING! By granting control to this user exit, DirectConnect has temporarily forfeited the management of Open Server threads and DirectConnect cannot ensure against ue_disconnect monopolizing execution, nor ue_disconnect’s ability to create a deadlock. Please use precautions to prevent this.

Example

See a sample implementation at the following location:

/<install_dir>/DC-15_0/servers/sample/trs/ue/ue_connect.cpp