ULCreateDatabase 方法

public ul_bool ULCreateDatabase(
    SQLCA * sqlca,
    char const * connect_parms,
    char const * create_parms,
    void * reserved
)

sqlca 指向已初始化的 SQLCA 的指针。
connect_parms 以分号分隔、以 "关键字值" 对形式设置的连接参数的字符串。连接字符串必须包含数据库名称。这些参数与可以在连接到数据库时指定的一组参数相同。
create_parms 以分号分隔、设置为 "关键字值" 对形式的数据库创建参数的字符串。例如：page_size=2048;obfuscate=yes。
保留此参数保留供将来使用。

如果成功创建数据库则返回 ul_true；如果创建失败则返回 ul_false。通常情况下，ul_false 是由文件名无效或访问被拒绝造成的。

创建数据库时通过以下两组参数提供信息。

connection-parms 是标准连接参数，只要访问数据库，就需要这些参数（例如，文件名、用户 id、口令、可选的加密密钥等等）。

creation-parms 是只有在创建数据库时才相关的参数（例如，模糊处理、页面大小、时间和日期格式等等）。初始化 SQLCA 后应用程序就可以调用此函数。

以下代码说明使用 ULCreateDatabase 创建一个文件 C:\myfile.udb 形式的 UltraLite 数据库：

if( ULCreateDatabase(&sqlca
    ,UL_TEXT("DBF=C:\myfile.udb;uid=DBA;pwd=sql")
    ,ULGetCollation_1250LATIN2()
    ,UL_TEXT("obfuscate=1;page_size=8192")
    ,NULL)
{
    // success
};

ULCreateDatabase 方法

语法

参数

返回值

注释