ULChangeEncryptionKeyW 方法

更改 UltraLite 数据库的加密密钥。

语法

public ul_bool ULChangeEncryptionKeyW(
    SQLCA * sqlca,
    ul_wchar const * new_key
)

参数

注释

注意

此方法原型当您在 Win32 平台上引用 ULChangeEncryptionKey 和 #define the UNICODE 宏时内部使用。通常，您创建 UltraLite 应用程序时不会直接引用此方法。

调用此函数的应用程序必须首先确保用户同步了数据库或者创建了数据库的可靠备份副本。拥有数据库的可靠备份很重要，因为 ULChangeEncryptionKey 是必须运行到结束的操作。数据库的加密密钥更改时，将首先使用旧密钥对数据库中的每一行解密，然后使用新密钥加密并重写。此操作是不可恢复的。如果加密更改操作没有完成，数据库将停留在无效状态，并且将无法再次访问。

使用DocCommentXchange 讨论此页。