|
1 | 1 | ---
|
2 |
| -title: "Rowset Properties and Behaviors | Microsoft Docs" |
| 2 | +title: "Rowset properties and behaviors (OLE DB driver) | Microsoft Docs" |
3 | 3 | description: "Rowset properties and behaviors in OLE DB Driver for SQL Server"
|
4 | 4 | ms.custom: ""
|
5 | 5 | ms.date: "06/14/2018"
|
@@ -31,7 +31,7 @@ ms.author: pelopes
|
31 | 31 | |DBPROP_BLOCKINGSTORAGEOBJECTS|R/W: Read-only<br /><br /> Default: VARIANT_TRUE<br /><br /> Description: The OLE DB Driver for SQL Server storage objects block using other rowset methods.|
|
32 | 32 | |DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS|R/W: Read/write<br /><br /> Default: VARIANT_FALSE<br /><br /> Description: The OLE DB Driver for SQL Server supports bookmarks for rowset row identification when DBPROP_BOOKMARKS or DBPROP_LITERALBOOKMARKS is VARIANT_TRUE.<br /><br /> Setting either property to VARIANT_TRUE does not enable rowset positioning by bookmark. Set DBPROP_IRowsetLocate or DBPROP_IRowsetScroll to VARIANT_TRUE to create a rowset supporting rowset positioning by bookmark.<br /><br /> The OLE DB Driver for SQL Server uses a [!INCLUDE[msCoName](../../../includes/msconame-md.md)] [!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] cursor to support a rowset that contains bookmarks. For more information, see [Rowsets and SQL Server Cursors](../../oledb/ole-db-rowsets/rowsets-and-sql-server-cursors.md).<br /><br /> Note: Setting these properties in conflict with other OLE DB Driver for SQL Server cursor-defining properties causes an error. For example, setting the DBPROP_BOOKMARKS to VARIANT_TRUE when DBPROP_OTHERINSERT is also VARIANT_TRUE generates an error when the consumer tries to open a rowset.|
|
33 | 33 | |DBPROP_BOOKMARKSKIPPED|R/W: Read-only<br /><br /> Default: VARIANT_FALSE<br /><br /> Description: The OLE DB Driver for SQL Server returns DB_E_BADBOOKMARK if the consumer indicates an invalid bookmark when positioning or searching a bookmarked rowset.|
|
34 |
| -|DBPROP_BOOKMARKTYPE|R/W: Read-only<br /><br /> Default: DBPROPVAL_BMK_NUMERIC<br /><br /> Description: The OLE DB Driver for SQL Server implements numeric bookmarks only. A OLE DB Driver for SQL Server bookmark is 32-bit unsigned integer, type DBTYPE_UI4.| |
| 34 | +|DBPROP_BOOKMARKTYPE|R/W: Read-only<br /><br /> Default: DBPROPVAL_BMK_NUMERIC<br /><br /> Description: The OLE DB Driver for SQL Server implements numeric bookmarks only. An OLE DB Driver for SQL Server bookmark is 32-bit unsigned integer, type DBTYPE_UI4.| |
35 | 35 | |DBPROP_CACHEDEFERRED|This rowset property is not implemented by the OLE DB Driver for SQL Server. Trying to read or write the property value generates an error.|
|
36 | 36 | |DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS|R/W: Read/write<br /><br /> Default: VARIANT_FALSE<br /><br /> Description: The OLE DB Driver for SQL Server supports backward fetching and scrolling in nonsequential rowsets. The OLE DB Driver for SQL Server creates a cursor-supported rowset when either DBPROP_CANFETCHBACKWARDS or DBPROP_CANSCROLLBACKWARDS is VARIANT_TRUE. For more information, see [Rowsets and SQL Server Cursors](../../oledb/ole-db-rowsets/rowsets-and-sql-server-cursors.md).|
|
37 | 37 | |DBPROP_CANHOLDROWS|R/W: Read/write<br /><br /> Default: VARIANT_FALSE<br /><br /> Description: By default, the OLE DB Driver for SQL Server returns DB_E_ROWSNOTRELEASED if the consumer tries to obtain more rows for a rowset while pending changes exist on those currently in the rowset. This behavior can be modified.<br /><br /> Setting both DBPROP_CANHOLDROWS and DBPROP_IRowsetChange to VARIANT_TRUE implies a bookmarked rowset. If both properties are VARIANT_TRUE, the **IRowsetLocate** interface is available on the rowset and DBPROP_BOOKMARKS and DBPROP_LITERALBOOKMARKS are both VARIANT_TRUE.<br /><br /> OLE DB Driver for SQL Server rowsets that contain bookmarks are supported by [!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] cursors.|
|
@@ -74,7 +74,7 @@ ms.author: pelopes
|
74 | 74 | |DBPROP_REPORTMULTIPLECHANGES|This rowset property is not implemented by the OLE DB Driver for SQL Server. Trying to read or write the property value generates an error.|
|
75 | 75 | |DBPROP_RETURNPENDINGINSERTS|R/W: Read-only<br /><br /> Default: VARIANT_FALSE<br /><br /> Description: When a method that fetches rows is called, the OLE DB Driver for SQL Server does not return pending insert rows.|
|
76 | 76 | |DBPROP_ROWRESTRICT|R/W: Read-only<br /><br /> Default: VARIANT_TRUE<br /><br /> Description: OLE DB Driver for SQL Server rowsets do not support access rights based on the row. If the **IRowsetChange** interface is exposed on a rowset, the **SetData** method can be called by the consumer.|
|
77 |
| -|DBPROP_ROWSET_ASYNCH|R/W: Read/write<br /><br /> Default: 0<br /><br /> Description: Provides for anychronous rowset processing. This property is in the Rowset property group and DBPROPSET_ROWSET property set. Type is VT_14.<br /><br /> The only value in the bitmask supported by OLE DB Driver for SQL Server is **DBPROPVAL_ASYNCH_INITIALIZE**.| |
| 77 | +|DBPROP_ROWSET_ASYNCH|R/W: Read/write<br /><br /> Default: 0<br /><br /> Description: Provides for asynchronous rowset processing. This property is in the Rowset property group and DBPROPSET_ROWSET property set. Type is VT_14.<br /><br /> The only value in the bitmask supported by OLE DB Driver for SQL Server is **DBPROPVAL_ASYNCH_INITIALIZE**.| |
78 | 78 | |DBPROP_ROWTHREADMODEL|R/W: Read-only<br /><br /> Default: DBPROPVAL_RT_FREETHREAD<br /><br /> Description: The OLE DB Driver for SQL Server supports access to its objects from multiple execution threads of a single consumer.|
|
79 | 79 | |DBPROP_SERVERCURSOR|R/W: Read/write<br /><br /> Default: VARIANT_FALSE<br /><br /> Description: When set, a [!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] cursor is used to support the rowset. For more information, see [Rowsets and SQL Server Cursors](../../oledb/ole-db-rowsets/rowsets-and-sql-server-cursors.md).|
|
80 | 80 | |DBPROP_SERVERDATAONINSERT|R/W: Read/write<br /><br /> Default: VARIANT_FALSE<br /><br /> Description: Server data on insert.<br /><br /> VARIANT_TRUE: At the time an insert is transmitted to the server, the provider retrieves data from the server to update the local row cache.<br /><br /> VARIANT_FALSE: The provider does not retrieve server values for newly inserted rows.|
|
|
0 commit comments