DBPROP_QUICKRESTART

OLE DB Programmer's Reference

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.

1998-2001 Microsoft Corporation. All rights reserved.