OLE DB Programmer's Reference | |
Property group: Initialization
Property set: DBPROPSET_DBINIT
Type: VT_I4
Typical R/W: R/W
Description: Bind Flags
A bitmask specifying flags that modify the behavior of the URL binding operation. A combination of zero or more of the following:
- DB_BINDFLAGS_COLLECTIONCreates the object as a collection.
- DB_BINDFLAGS_DELAYFETCHCOLUMNSOn a bind to a row object, this flag overrides the consumer's intent to immediately access the row's columns. Absence of this flag is a hint to the provider to download or prefetch the row's columns.
- DB_BINDFLAGS_DELAYFETCHSTREAMOn a bind to a row object, this flag overrides the consumer's intent to immediately open the default stream. Absence of this flag is a hint to the provider to instantiate the default stream object and prefetch its contents.
- DB_BINDFLAGS_ISSTRUCTUREDDOCUMENTCreates the object as a structured document.
- DB_BINDFLAGS_OPENIFEXISTSIf the resource exists and is not a collection, it is opened. If the resource does not exist, it is created.
- DB_BINDFLAGS_OUTPUTBind to the resource's executed output rather than its source. (For example, this will retrieve the HTML generated by an ASP file rather than its source.) This flag is ignored on binds to collections.
- DB_BINDFLAGS_OVERWRITEDeletes and re-creates a named object if it exists. This flag may not be used with DBBINDURLFLAG_OPENIFEXISTS.
- DB_BINDFLAGS_RECURSIVEModifies DBBINDURLFLAG_SHARE_*. Propagates sharing restrictions to all objects in the subtree. Has no effect when binding to leaf nodes. Specifying this flag with only DBBINDURLFLAG_SHARE_DENY_NONE (or equivalently, with no SHARE_DENY flags) will result in E_INVALIDARG.
For more information, see the reference entries for IBindResource::Bind and ICreateRow::CreateRow.
1998-2001 Microsoft Corporation. All rights reserved.