Share via


Property Groups and Properties

 

Microsoft Corporation

This section of the OLE DB security administration guide lists the following property group and properties that are defined for OLE DB security management:

  • Trustee Property Group
  • DBPROP_TRUSTEE_AUTHENTICATION
  • DBPROP_TRUSTEE_NEWAUTHENTICATION
  • DBPROP_TRUSTEE_USERNAME

Trustee Property Group

Property Set: DBPROPSET_TRUSTEE

Property Flag: DBPROPFLAGS_TRUSTEE

Properties  
DBPROP_TRUSTEE_AUTHENTICATION DBPROP_TRUSTEE_USERNAME
DBPROP_TRUSTEE_NEWAUTHENTICATION  

DBPROP_TRUSTEE_AUTHENTICATION

Property group: Trustee

Property set: DBPROPSET_TRUSTEE

Column? N

Type: VT_BSTR

Typical R/W: W

Description: Authentication String

The authentication string is typically a password associated with the trustee.

Ordinarily, to set any other properties on the trustee, the authentication string must be specified.

The authentication string is generally not retrievable. Attempting to retrieve the authentication string returns DBPROPSTATUS_NOTAVAILABLE.

DBPROP_TRUSTEE_NEWAUTHENTICATION

Property group: Trustee

Property set: DBPROPSET_TRUSTEE

Column? N

Type: VT_BSTR

Typical R/W: W

Description: New Authentication String

The new authentication string is typically used to set a new password for the trustee.

To set a new authentication string, the consumer will ordinarily specify the current authentication string as well as the new authentication string. That is, the property set will contain both a DBPROP_TRUSTEE_AUTHENTICATION as well as a DBPROP_TRUSTEE_NEWAUTHENTICATION property.

Attempting to retrieve this property returns DBPROPSTATUS_ NOTAVAILABLE.

DBPROP_TRUSTEE_USERNAME

Property group: Trustee

Property set: DBPROPSET_TRUSTEE

Column? N

Type: VT_BSTR

Typical R/W: R/W

Description: Trustee User Name

This is a descriptive, human-readable form of the user name associated with the trustee.