IRepositoryODBC Interface
The repository engine stores information in an SQL database. The repository engine connects to the database server through an ODBC connection. The IRepositoryODBC interface provides you with access to the database through the same (or a similar) ODBC connection.
Care should be taken when accessing the repository database directly, especially when sharing the repository ODBC connection. Specific restrictions are defined in the detailed information for each interface method. Directly accessing the repository database in a read-only manner is generally considered safe; however, if you tune your repository application to be dependent upon specific features of your database server, you limit the portability of your application.
When to Use
Use the IRepositoryODBC interface to obtain or release an ODBC connection handle, or to retrieve the ODBC connection string used by the repository engine.
To obtain a pointer to this interface, use the IRepository::QueryInterface method.
Methods
| IUnknown method | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments the reference count. |
| Release | Decrements the reference count. |
| IDispatch method | Description |
|---|---|
| GetIDsOfNames | Maps a single member and a set of argument names to a corresponding set of dispatch identifiers. |
| GetTypeInfo | Retrieves a type information object, which can be used to get the type information for an interface. |
| GetTypeInfoCount | Retrieves the number of type information interfaces that an object provides (either 0 or 1). |
| Invoke | Provides access to properties and methods exposed by an Automation object. |
| IRepositoryODBC method | Description |
|---|---|
| ExecuteQuery | Executes the specified SQL query against the repository database. |
| FreeConnection | Releases an ODBC connection handle. |
| get_ConnectionString | Retrieves the ODBC connection string that the repository engine uses to obtain an ODBC connection. |
| GetNewConnection | Obtains a new ODBC connection handle using the same connection settings that the repository engine is using to access the repository database. |
| get_ReposConnection | Retrieves the ODBC connection handle that the repository engine is using to access the repository database. |