Property Sets

OLE DB Programmer's Reference

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.

1998-2001 Microsoft Corporation. All rights reserved.