Client :: openDataSource - Open data source
The data source to be opened must be defined in the configuration file (ini-file) passed to the main client (open(sIniFile,...)) or in the data catalog, when a data catalog section (DATA_CATALOG) has been defined in the configuration file for the main client.
When the data source has been opened successfully the function returns the corresponding object space handle. Otherwise the function throws an exception.
An Object Space, conceivably not yet opened.
Implementation details
The function opens the data source with the data source name passed in sDataSourceName and with access mode passed in eAccessMode. The data source name must refer to a section name in the ini- or configuration file or to a data source name in the data catalog. The access mode defined for the data source may be overwritten with the passed access mode.
- sDataSourceName
- Data source name
The name of the data source refers to a section in a configuration or ini-file or to a data source defined in the data catalog defined for the application. Other data source variables are set from the data source definition referred to by the data source name.
- eAccessMode
- Access mode
Access mode for a property handle or database.