IDBDataSourceAdmin

This section describes Jet-specific implementation of the IDBDataSourceAdmin interfaces. This includes IDBDataSourceAdmin::CreateDataSource, IDBDataSourceAdmin::DestroyDataSource, IDBDataSourceAdmin::GetCreationProperties, and IDBDataSourceAdmin::ModifyDataSource.

IDBDataSourceAdmin is an interface for creating, destroying, and modifying data sources.

It is important to distinguish between the data source object and the data source. The data source object is the object used by the consumer code. The data source is the actual source of the data, such as a server database.

IDBDataSourceAdmin::CreateDataSource

Creates a new data source and data source object, and initializes the data source object to the data source. For information on how this interface is implemented, see the OLE DB Programmer’s Reference.

No data source creation properties are supported. For a complete description of the supported DBPROPSET_DBINIT and DBPROPSET_SESSION properties, see Appendix A.

Note   IDBDataSourceAdmin::CreateDataSource will create all new databases in an exclusive mode, regardless of what you set for DBPROP_INIT_MODE. If you want others to be able to open your newly created databases, then you need to close the database and open it again using Initialize/CreateSession with the desired DBPROP_INIT_MODE setting.

IDBDataSourceAdmin::DestroyDataSource

Destroys the current data source and leaves the data source object in an uninitialized state.

This interface is not supported in this provider.

IDBDataSourceAdmin::GetCreationProperties

Returns information about the data source creation properties supported by the data provider. For information on how this interface is implemented, see the OLE DB Programmer’s Reference.

For a complete description of the supported DBPROPSET_DBINIT and DBPROPSET_SESSION properties, see Appendix A.

IDBDataSourceAdmin::ModifyDataSource

Modifies the current data source.

This interface is not supported in this provider.