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。
reserved 此参数保留供将来使用。

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

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

connect_parms 参数是在任意时间访问数据库时均可使用的一系列连接参数。其中包括如文件名称、用户 ID、口令或可选加密密钥。

create_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 方法

语法

参数

返回值

注释

另请参见