Advantage Client Engine
Decrypts an entire table
UNSIGNED32 |
AdsDecryptTable (ADSHANDLE hTable); |
hTable (I) |
Handle of a table. |
AdsDecryptTable will traverse the entire table and decrypt all records with the password set via AdsEnableEncryption. Use of this function requires exclusive use of the table. If a record in the table is already unencrypted, it will be skipped.
The encryption information in the table header will be cleared automatically after the decrypt table operation has completed. Encryption will be disabled after the decrypt table operation has completed; that is, subsequent updates to the records will be written in unencrypted format.
Decrypting a table within a transaction is not allowed.
Note AdsDecryptTable only accepts table handles. The use of a cursor handle with this API is illegal and will result in an error. See AdsExecuteSQL for more detail.
Note AdsDecryptTable is only applicable with free tables. The encryption process is done automatically with database tables. ALTER permissions on the table are required to encrypt or decrypt database tables. See Advantage Data Dictionary for more information.