2.15 Contents of RWDBSystemHandle

The RWDBConnection::systemHandle() method returns a pointer to a base class from which a family of implementation-specific classes is derived. To use the database API directly, an application can downcast this pointer to the appropriate type, and use its implementation-specific features. Naturally, this usage reduces an application's portability.

In the case of an Informix connection, the implementation-specific system handle has the datatype RWDBInformixSystemHandle. It contains the SQLHDBC used by the RWDBConnection. The following method may be used to retrieve this component:

SQLHDBC hdbc();

If it is necessary for your application to make calls directly to the Informix ODBC Driver API, proceed as in the following example:

#include <windows.h>
#include <sql.h>
#include <sqlext.h>
#include <rw/db/infsrc/infsysh.h>

RWDBConnection infConnect = myDbase.connection();
RWDBInformixSystemHandle* handle = (RWDBInformixSystemHandle *) 
                                   infConnect.systemHandle();
SQLHDBC sqlhdbc = handle->hdbc();
// Use sqlhdbc for Informix ODBC Driver API calls.