MDAC 2.5 SDK - OLE DB Programmer's Reference
OLE DB Interfaces

IDBProperties

IDBProperties is used to set and get the values of properties on the data source object or enumerator and to get information about all properties supported by the provider. For OLE DB 2.5 providers that support direct URL binding, this interface is implemented on binder objects via IDBBinderProperties, which is derived from IDBProperties.

A data source object or enumerator that has not been initialized or that has been uninitialized is in an uninitialized state. When a data source object or enumerator is in this state, the consumer can work only with properties of that object that belong to the Initialization property group.

After the data source object or enumerator is initialized, it is in an initialized state (until it is uninitialized). When the data source object or enumerator is in this state, the consumer can work with properties of that object that belong to the Initialization, Data Source, and Data Source Information property groups. However, the consumer cannot set the value of properties in the Initialization property group.

Only properties in the Initialization property group are guaranteed to survive uninitialization. That is, if the consumer uninitializes and reinitializes a data source object or enumerator, it might need to reset the values of properties in groups other than Initialization.

IDBProperties is a mandatory interface for data source objects and an optional interface for enumerators. However, if an enumerator exposes IDBInitialize, it must expose IDBProperties.