DbiAddPassword

C syntax

DBIResult DBIFN DbiAddPassword (pszPassword);

Delphi syntax

function DbiAddPassword (pszPassword: PChar): DBIResult stdcall;

Description

DbiAddPassword adds a password to the current session. This function is supported for Paradox tables only.

Parameters

pszPassword Type: pCHAR (Input)
Pointer to the password to be added.

Usage

DbiAddPassword provides users with access to a previously encrypted table (adding a password does not encrypt the table). Examples of operations on an encrypted table include: opening the table, record and field access on the table, and batch functions (copy, delete, empty, or restructure). DbiCreateTable and DbiDoRestructure can be used to place or remove table encryption.

Paradox: Table and field level security is supported for the Paradox driver only.

SQL: This function is not supported with SQL tables. Access rights for SQL drivers are controlled when the database is opened.

DbiResult	Meaning
DBIERR_NONE	The password was successfully added.
DBIERR_PASSWORDLIMIT	Maximum number of passwords have already been added.
DBIERR_INVALIDPASSWORD	The specified password is invalid (for example, it is too long or contains invalid characters).