Connecting to a Service

Before using a component's operations, the thin client must first connect to a Server running a service that supports the component. You do this with the function ostc::connect().

Example

      _session = ostc::connect("quickstart");

Click here for the example in context.

Service Name

"quickstart" is the name of a service that supports the component or components you want to use during the current session. If there is more than one Server that is running the specified service, a router chooses a Server to connect to.

Return Value

_session, the return value, is a pointer to an instance of the class ostc_Session, which represents the thin client's current session with the specified service. You use members of this class to retrieve the operations supported by the Server's service, as well as to send operation execution requests.

Multithreaded Thin Clients

You should retrieve only one session per client thread. Session objects are cached, making connect() (and disconnect()) inexpensive operations.