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 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.

Show: