DBPROP_QUICKRESTART
Property group: Rowset
Property set: DBPROPSET_ROWSET
Column? N
Type: VT_BOOL
Typical R/W: R/W
Description: Quick Restart
Value |
Meaning |
|---|---|
VARIANT_TRUE |
IRowset::RestartPosition is relatively quick to execute. In particular, it does not reexecute the command that created the rowset. |
VARIANT_FALSE |
RestartPosition is expensive to execute and requires reexecuting the command that created the rowset. |
Although the value of this property can be set to VARIANT_TRUE, the provider is not required to honor it. The reason for this is that the provider does not know what the command is at the time the property is set; in particular, the consumer can set this property and then change the command text. However, the provider can fail this property if it is never able to quickly restart the next fetch position. Therefore, if a consumer successfully sets this property, it must still check this flag on the rowset to determine if the next fetch position can be quickly set.