2.2.1.2.1 Element-Specific Attributes

Attribute name

Description

action

(optional) If specified, the value MUST be C, D, R, or U, corresponding to Create, Delete, Replace, and Update. If unspecified, the default value is U.

Create: This action MUST be used to create a new data source name for the user or computer. If the data source exists, then the protocol MUST NOT create a new data source and MUST NOT return an error.

Delete: This action MUST be used to remove a data source from the user or computer. If the data source does not exist, the protocol MUST NOT perform an action and MUST NOT return an error.

Replace: This action MUST be used to delete and re-create a data source for the user or computer. The net result of the Replace action MUST overwrite all existing settings associated with the data source. If the data source does not exist, then the Replace action MUST create the new data source.

Update: This action MUST be used to modify the settings of an existing data source name. This action differs from Replace in that it MUST only update settings that are defined within the preference item. All other settings MUST remain as previously configured. If the data source does not exist, then the Update action MUST create a new data source.

userDSN

(optional) Sets the visibility of the data source. User data sources are available to users receiving the preference item. System data sources are available to all the users of the computer (including Local System). If 1, the client MUST create a data source accessible only to the user that is logged on. If 0, the client MUST create a data source accessible to all users.

dsn

MUST be the name used to identify the data source.

driver

MUST be the name of the ODBC driver used to connect to the data provider.

description

(optional) MUST provide text used to describe the data source. This field accepts environment variables, which MUST be resolved prior to creating the data source.

username

(optional) MUST be the user name used to connect to the indicated data source. The username MUST be in NETBIOS format domain\username.

cpassword

(optional) MUST set the password used to connect to the indicated data source. The password is encrypted using an AES derived encryption key when the preference is created and decrypted in the client during client processing.

Attributes

(optional) Defines a set of Attribute elements that the client MUST pass to the ODBC driver.

Attribute: (optional) Settings that are passed through to the ODBC driver. Each name/value pair is driver specific. An informative description of driver parameters can be found at [MSDN-ACCESSDRIVER].

name: A value that MUST be passed to the ODBC driver and which is driver specific.

value: A value that MUST be passed to the ODBC driver and which is driver specific.

Show: