DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

OLE DB Programmer's Reference

Property group: Initialization

Property set: DBPROPSET_DBINIT

Type: VT_BOOL

Typical R/W: R/W

Description: Persist Security Info

Value	Meaning
VARIANT_TRUE	The data source object is allowed to persist sensitive authentication information such as a password along with other authentication information.
VARIANT_FALSE	The data source object cannot persist sensitive authentication information.

If DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO is set to VARIANT_FALSE at the time the data source object is initialized, the data source object cannot persist sensitive authentication information. Furthermore, requesting properties that contain sensitive authentication information, such as a password, returns some default value instead of the actual password.

After the data source object has been uninitialized, sensitive information that was set when the data source object was initialized with the DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO property set to VARIANT_FALSE still cannot be obtained through IDBProperties::GetProperties or by persisting the uninitialized data source object, but new properties set after the data source object has been uninitialized can be persisted or obtained as long as DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO is VARIANT_TRUE.

Before the data source object is initialized for the first time, sensitive information can be obtained by calling IDBProperties::GetProperties and can be persisted, regardless of the setting of DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO. For this reason, consumers should not pass around uninitialized data source objects.

1998-2001 Microsoft Corporation. All rights reserved.