Initialization Properties

The DBPROPSET_DBINIT property set contains the following properties. All of these properties are in the Initialization property group.

Property ID (properties not supported

in DBPROPSET_DBINIT)

Description

DBPROP_AUTH_CACHE_AUTHINFO

Type: VT_BOOL

Typical R/W: R only

Description: Cache Authorization

For this provider, the value is always VARIANT_TRUE, which indicates that the data source object or enumerator is allowed to cache sensitive authentication information, such as a password, in an internal cache.

DBPROP_AUTH_ENCRYPT_PASSWORD

Type: VT_BOOL

Typical R/W: R only

Description: Encrypt Password

For this provider, the value is always VARIANT_FALSE, which indicates that the password can be sent without encryption.

DBPROP_AUTH_MASK_PASSWORD

Type: VT_BOOL

Typical R/W: R only

Description: Mask Password

Specifies values as either:

  • VARIANT_TRUE, which indicates that the consumer requires that the password be sent to the data source object or enumerator in a masked form.

  • VARIANT_FALSE, which indicates that the password can be sent in an unmasked form.

DBPROP_AUTH_PASSWORD

Type: VT_BSTR

Typical R/W: R/W

Description: Password

Specifies the password to be used when connecting to the data source object or enumerator.

DBPROP_AUTH_PERSIST_ENCRYPTED

Type: VT_BOOL

Typical R/W: R only

Description: Persist Encrypted

For this provider, the value is always VARIANT_FALSE, which indicates that the data source object can persist sensitive authentication information without encryption.

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

Type: VT_BOOL

Typical R/W: R only

Description: Persist Security Info

For this provider, the value is always VARIANT_FALSE, which indicates that the data source object cannot persist sensitive authentication information.

DBPROP_AUTH_USERID

Type: VT_BSTR

Typical R/W: R/W

Description: User ID

Specifies the user ID to be used when connecting to the data source object or enumerator.

DBPROP_INIT_ASYNCH

Type: VT_I4

Typical R/W: R/W

Description: Asynchronous Processing

Not supported by this provider.

DBPROP_INIT_DATASOURCE

Type: VT_BSTR

Typical R/W: R/W

Description: Data Source

Specifies the name of the data store to which to connect.

DBPROP_INIT_HWND

Type: VT_I8 (64-bit operating systems) or VT_I4 (32-bit operating systems)

Typical R/W: R/W

Description: Window Handle

Specifies the window handle to be used if the data source object or enumerator needs to prompt for additional information.

DBPROP_INIT_LCID

Type: VT_I4

Typical R/W: R/W

Description: Locale Identifier

The locale ID (LCID) of preference for the consumer. Consumers specify the LCID at initialization. This provides a method by which the server can determine the consumer's LCID of choice. This property does not guarantee that all text returned to the consumer will be translated according to the LCID.

DBPROP_INIT_MODE

Type: VT_I4

Typical R/W: R/W

Description: Mode

Specifies a bitmask that indicates access permissions; that is, zero or more of:

  • DB_MODE_READ, which indicates read-only.

  • DB_MODE_READWRITE, which indicates read/write (DB_MODE_READ | DB_MODE_WRITE).

  • DB_MODE_SHARE_DENY_READ, which prevents others from opening in read mode.

  • DB_MODE_SHARE_EXCLUSIVE, which prevents others from opening in read/write mode (DB_MODE_SHARE_DENY_READ | DB_MODE_SHARE_DENY_WRITE).

  • DB_MODE_SHARE_DENY_NONE, which indicates that neither read nor write access can be denied to others.

DBPROP_INIT_PROMPT

Type: VT_I2

Typical R/W: R only

Description: Prompt

Specifies whether to prompt the user during initialization; that is:

  • DBPROMPT_PROMPT, which indicates that the user is always prompted for initialization information.

  • DBPROMPT_COMPLETE, which prompts the user only if more information is needed.

  • DBPROMPT_COMPLETEREQUIRED, which prompts the user only if more information is needed.

  • DBPROMPT_NOPROMPT, which does not prompt the user.

DBPROP_INIT_PROVIDERSTRING

Type: VT_BSTR

Typical R/W: R/W

Description: Extended Properties

Specifies a string that contains provider-specific, extended connection information. Use of this property implies that the consumer knows how this string will be interpreted and used by the provider. Consumers should use this property only for provider-specific connection information that cannot be explicitly described through the property mechanism.

For this provider, this property is used to pass the Jet connect string for opening or creating databases.