| title | description | author | ms.author | ms.date | ms.service | ms.subservice | ms.topic | helpviewer_keywords | ||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Data source properties (OLE DB driver) |
Learn how OLE DB Driver for SQL Server implements data source properties, including a provider-specific property set with additional data source properties. |
David-Engel |
v-davidengel |
06/14/2018 |
sql |
connectivity |
reference |
|
[!INCLUDE SQL Server]
[!INCLUDEDriver_OLEDB_Download]
The OLE DB Driver for SQL Server implements data source properties as follows.
| Property ID | Description |
|---|---|
| DBPROP_CURRENTCATALOG | R/W: Read/write Default: None Description: The value of DBPROP_CURRENTCATALOG reports the current database for a OLE DB Driver for SQL Server session. Setting the property value has the identical effect as setting the current database by using the [!INCLUDEtsql] USE database statement. Beginning with [!INCLUDEssVersion2005], if you call sp_defaultdb and specify the database name in lower case, even if the database was originally created with a mixed case name, DBPROP_CURRENTCATALOG will return the name in lower case. With previous versions of [!INCLUDEssNoVersion], DBPROP_CURRENTCATALOG will return the expected mixed case. |
| DBPROP_MULTIPLECONNECTIONS | R/W: Read/write Default: VARIANT_FALSE Description: If the connection is running a command that does not produce a rowset or produces a rowset that is not a server cursor and you execute another command, a new connection will be created to execute the new command if DBPROP_MULTIPLECONNECTIONS is VARIANT_TRUE. The OLE DB Driver for SQL Server will not create another connection if DBPROP_MULTIPLECONNECTION is VARIANT_FALSE or if a transaction is active on the connection. The OLE DB Driver for SQL Server returns DB_E_OBJECTOPEN if DBPROP_MULTIPLECONNECTIONS is VARIANT_FALSE and returns E_FAIL if there is an active transaction. Transactions and locking are managed by [!INCLUDEssNoVersion] on a per connection basis. If a second connection is generated, the commands on the separate connections do not share locks. To ensure that one command does not block another, hold locks on rows requested by the other command. This also holds true when creating multiple sessions. Each session has a separate connection. |
In the provider-specific property set DBPROPSET_SQLSERVERDATASOURCE, the OLE DB Driver for SQL Server defines the following additional data source properties.
| Property ID | Description |
|---|---|
| SSPROP_ENABLEFASTLOAD | R/W: Read/write Default: VARIANT_FALSE Description: To enable bulk copy from memory, SSPROP_ENABLEFASTLOAD property should be set to VARIANT_TRUE. With this property set on the data source, the newly created session allows consumer access to the IRowsetFastLoad interface. If the property is set to VARIANT_TRUE, IRowsetFastLoad interface is available through IOpenRowset::OpenRowset by requesting the IID_IRowsetFastLoad interface or by setting SSPROP_IRowsetFastLoad to VARIANT_TRUE. |
| SSPROP_ENABLEBULKCOPY | R/W: Read/write Default: VARIANT_FALSE Description: To enable bulk copy from files, SSPROP_ENABLEBULKCOPY property should be set to VARIANT_TRUE. With this property set on the data source, consumer access to the IBCPSession interface is available under the same level as Sessions. SSPROP_IRowsetFastLoad must also be set to VARIANT_TRUE. |