Function AX_SetPass() Professional
Sets the password used for encryption/decryption operations.
AX_SetPass( <cPassword> ) --> lSuccess
The function returns a logical value indicating whether the password is successfully set ( .T. ) or if the operation failed ( .F. ). A failed operation causes an error code that can be retrieved via the :getLastError() method of the DacSession object.
To initiate encryption and decryption in the current workarea, a single call to AX_SetPass() should be made.
After the password is successfully set, all new records appended or updated are encrypted before are stored.
Note that if a file has been encrypted without a prior call to AX_SetPass(), it also needs to be decrypted without a call of this function. If no password has been set, eight ASCII 0's are used for encryption and decryption.
To assure that the password is not easy accessible at runtime, it is stored in an encrypted form in memory.
1. Re-encrypt the table with the WRONG password. (Put it back to its former state.)
2. Set the CORRECT password.
3. Now decrypt the file with the CORRECT password.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.