Connection Handles

A connection handle is a representation of a physical connection. The connection handle defines not only which driver to use but which data source to use with that driver. Within a segment of code the connection handle identifies a structure that contains connection information.

You can obtain a connection handle by using cbrx_connection_open

If there is no activity on an open handle for more than 30s, the handle will become invalid. Subsequent calls attempting to use a deleted handle will fail with CBRXAPI_ERRORCODE_INVALIDHANDLE. Software using the API must be able to cope with this situation and respond accordingly. Software may simply call cbrx_connection_open again in order to obtain a fresh handle, or if you register for notifications they will be left open indefinitley.