Advantage TDataSet Descendant
Enables record-based Advantage encryption and decryption
procedure AdsEnableEncryption ( strPassword : String );
|
strPassword |
Case-sensitive text password. |
This function enables encryption and decryption of individual records in the specified dataset. After a successful call to AdsEnableEncryption, any record that is updated will also be encrypted. Also, any record read that was previously encrypted will be viewed in its unencrypted form. If the current record in a table needs to be encrypted, but not updated, use AdsEncryptRecord. If all records in a table need to be encrypted, use AdsEncryptTable. To write a previously encrypted record in its decrypted form, see AdsDecryptRecord.
Only one password can be used to encrypt records in a dataset. When encryption is enabled for the first time on a dataset, the table header is updated with the encryption information. Subsequent requests to enable encryption on the dataset will only succeed if the correct password is supplied. To remove encryption from a table header, see AdsDecryptTable.
If AdsEnableEncryption fails for any reason, any encrypted records will be treated as read-only. If the entire dataset is encrypted, the entire dataset will be treated as read-only.
Note The password is case-sensitive. Using "secret" will encrypt data differently than "SECRET".
Note AdsEnableEncryption is only applicable with free tables. The encryption process is done automatically with database tables. Data dictionary administrative access is required to encrypt or decrypt database tables. See Advantage Data Dictionary for more information.
AdsTable1.Active := TRUE;
AdsTable1.AdsEnableEncryption( 'secret' );