Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.0 » UltraLite - C and C++ Programming » API Reference » Embedded SQL API reference


ULChangeEncryptionKey function

Changes the encryption key for an UltraLite database.

ul_bool ULChangeEncryptionKey(
SQLCA *sqlca, 
ul_char *new_key

Applications that call this function must first ensure that the user has either synchronized the database or created a reliable backup copy of the database. It is important to have a reliable backup of the database because ULChangeEncryptionKey is an operation that must run to completion. When the database encryption key is changed, every row in the database is first decrypted with the old key and then encrypted with the new key and rewritten. This operation is not recoverable. If the encryption change operation does not complete, the database is left in an invalid state and you cannot access it again.

See also