DBPROP_CANHOLDROWS
Property group: Rowset
Property set: DBPROPSET_ROWSET
Column? N
Type: VT_BOOL
Typical R/W: R/W
Description: Hold Rows
Value |
Meaning |
|---|---|
VARIANT_TRUE |
The rowset allows the consumer to retrieve more rows or change the next fetch position, while holding previously fetched rows or rows with pending changes. |
VARIANT_FALSE |
The rowset might require pending changes to be transmitted to the data store and all rows to be released before fetching additional rows, inserting new rows, or changing the next fetch position. |
Note
If the provider makes no optimizations for releasing all rows between fetches, it is not required to return DB_E_ROWSNOTRELEASED when retrieving rows without releasing the previously held set of row handles. Such providers do not return an error when setting DBPROP_CANHOLDROWS to VARIANT_FALSE but always return VARIANT_TRUE if the consumer calls IRowsetInfo::GetProperties for DBPROP_CANHOLDROWS.