MDAC 2.5 SDK - OLE DB Providers
OLE DB Provider for Microsoft Jet


 

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_I4

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.