IDBProperties | Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)

OLE DB Programmer's Reference

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.

Method	Description
GetProperties	Returns the values of properties in the Data Source, Data Source Information, and Initialization property groups that are currently set on the data source object, or the values of properties in the Initialization property group that are currently set on the enumerator.
GetPropertyInfo	Returns information about all properties supported by the provider.
SetProperties	Sets properties in the Data Source and Initialization property groups, for data source objects, or in the Initialization property group, for enumerators.