Property Sets

  • Article

The following table shows property sets that are defined by OLE DB. Providers also can define their own property sets.

Property set GUID

Description

DBPROPSET_COLUMN

All OLE DB?defined properties in the Column property group.

DBPROPSET_DATASOURCE

All OLE DB?defined properties in the Data Source property group.

DBPROPSET_ DATASOURCEINFO

All OLE DB?defined properties in the Data Source Information property group.

DBPROPSET_DBINIT

All OLE DB?defined properties in the Initialization property group.

DBPROPSET_INDEX

All OLE DB?defined properties in the Index property group.

DBPROPSET_ROWSET

All OLE DB?defined properties in the Rowset property group.

DBPROPSET_SESSION

All OLE DB?defined properties in the Session property group.

DBPROPSET_STREAM

All OLE DB?defined properties in the Stream property group.

DBPROPSET_TABLE

All OLE DB?defined properties in the Table property group.

DBPROPSET_PROPERTIESINERROR

If ICommand::Execute, ICommandPrepare::Prepare, IDBInitialize::Initialize, IBindResource::Bind, or ICreateRow::CreateRow returns DB_S_ERRORSOCCURRED or DB_E_ERRORSOCCURRED, the consumer can immediately call ICommandProperties::GetProperties or IDBProperties::GetProperties with a single DBPROPIDSET structure to return all the properties that were in error. This property set is not returned by IDBProperties::GetPropertyInfo.

In the DBPROPIDSET structure, the consumer sets guidPropertySet to DBPROPSET_PROPERTIESINERROR, cPropertyIDs to 0, and rgPropertyIDs to a null pointer. If the consumer fails to set any of these correctly, GetProperties returns E_INVALIDARG.

It is an error to pass this property set to any method that sets properties. The method returns the same error it would for any other unsupported property set. Methods that return information about properties do not return information about this property set. If any other property sets are passed to GetProperties with this property set, GetProperties returns E_INVALIDARG. Calling GetProperties with DBPROPSET_PROPERTIESINERROR at a time other than immediately after the call that returns DB_S_ERRORSOCCURRED or DB_E_ERRORSOCCURRED might yield inconsistent results, because the consumer's actions might have caused the provider to clear or alter the list of properties in error.

DBPROPSET_VIEW

All OLE DB?defined properties in the View property group.