Jump to: navigation, search

TOpenServerX

Description

Opens a communication session to the T-Server specified by the conn_param argument, and designates the event-processing function to be invoked each time an event from T-Server is detected. Use this function (instead of TOpenServer() or TOpenServerEx()) to set up an ADDP-compliant connection to T-Server. ADDP provides timely detection of TCP/IP connections, or failures, where the TCP/IP itself fails to provide the same information in a timely manner.

Parameters

Name Description
conn_param A pointer to an XKVList type containing a description of the connection. The following table describes the information contained in this XKVList .
dispatch_function A pointer to the function that will be called when an event from T-Server arrives.
application_name A pointer to the application name.
application_password A pointer to the string containing the tenant name and the tenant password separated by a slash (/).
open_mode Set of flags specifying the mode in which the connection is open.

Return Values

> 0 — A local server handle to the specific T-Server; in other words, a unique identifier assigned by T-Library to the connection between a client and T-Server. The handle is used subsequently to send requests to T-Server throughout this communication session.

< 0 — Error condition. Returned to the application if the communication session with the T-Server could not be established.

This page was last edited on June 27, 2017, at 20:21.
Comments or questions about this documentation? Contact us for support!