company logo

DataSourceHandle :: OpenDBObject - Open DBObjectHandle

The DBObjectHandle is opened for the database object defined in the database path (object_name). The DatabaseHandle of the DataSource must be opened before. If the DBObjectHandle is already opened it will be closed before opening the new DBObjectHandle (CloseDBObject()).

When the object name is empty the root object of the opened database is provided.

Return value:  Reference to database object handle ( DBObjectHandle & )

In many cases, the handle actually refers to a dictionary or database handle, which are database object handle as well.

Implementation details

DBObjectHandle & DataSourceHandle  :: OpenDBObject (  )