Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)

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_COLLECTION—Creates the object as a collection.
• DB_BINDFLAGS_DELAYFETCHCOLUMNS—On 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_DELAYFETCHSTREAM—On 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_ISSTRUCTUREDDOCUMENT—Creates the object as a structured document.
• DB_BINDFLAGS_OPENIFEXISTS—If the resource exists and is not a collection, it is opened. If the resource does not exist, it is created.
• DB_BINDFLAGS_OUTPUT—Bind 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_OVERWRITE—Deletes and re-creates a named object if it exists. This flag may not be used with DBBINDURLFLAG_OPENIFEXISTS.
• DB_BINDFLAGS_RECURSIVE—Modifies 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.