DB_ChangePassword

This function changes the current password on the file. Either a NULL pointer or a null string ("") can be passed to indicate no password; both are equivalent. Changing the password does garbage collection, so an DB_Undo cannot be executed immediately afterwards. Changing the password requires rewriting all records in the database, and may take a while.

• Syntax:             int DB_ChangePassword(DBBLOCK *dblk, char *oldpassword,
                      char *newpassword); 

• Returns: DB_OK Password was changed or the new password is not different from the old password.

  DB_PASSWORDFAILED The old password is invalid.

  DB_SEEK File is probably corrupt.

  DB_READ Media error.

  DB_WRITE Media error.

• May Move Memory: No