2.16 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 ODBC connection, the implementation-specific system handle has the data type RWDBODBCLibSystemHandle. 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 ODBC API, proceed as in the following example:

#include <windows.h>
#include <sql.h>
#include <sqlext.h>
#include <rw/db/odbcsrc/odbsysh.h>

RWDBConnection odbcConnect = myDbase.connection();
RWDBODBCLibSystemHandle* handle = (RWDBODBCLibSystemHandle *) 
                                   odbcConnect.systemHandle();
SQLHDBC sqlhdbc = handle->hdbc();
// Use sqlhdbc for ODBC API calls.

© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.