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

SQL Anywhere 11.0.1 (中文) » UltraLite - C 及 C++ 编程 » API 参考 » UltraLite C/C++ 公共 API 参考

 

ULCreateDatabase 函数

创建 UltraLite 数据库。

语法
ul_bool ULCreateDatabase ( SQLCA * sqlca, 
 ul_char * connection-parms, 
 void const  * collation,
 ul_char * creation-parms,
 void * reserved
  );                                  
参数

sqlca   指向已初始化的 SQLCA 的指针。

connection-parms   以分号分隔、以 "关键字值" 对形式设置的连接参数的字符串。连接字符串必须包含数据库名称。这些参数与可以在连接到数据库时指定的一组参数相同。有关完整列表,请参见UltraLite 连接参数

归类   数据库的所需归类序列。可通过调用相应函数获取归类序列。例如:

void const * collation = ULGetCollation_1250LATIN2(); 

通过在所需归类的名称前加上 ULGetCollation_ 前缀构成函数名。有关所有可用归类函数的列表,请参见 install-dir\SDK\Include\ulgetcoll.h。在调用任何一个 ULGetCollation_ 函数的程序中必须包括此文件。

creation-parms   以分号分隔、设置为 "关键字值" 对形式的数据库创建参数的字符串。例如:

page_size=2048;obfuscate=yes

有关完整列表,请参见为 UltraLite 选择数据库创建参数

保留   此参数保留供将来使用。

返回值
  • ul_true   表示成功创建了数据库。

  • ul_false   详细的错误消息由 SQLCA 中的 SQLCODE 字段定义。通常情况下,此错误是由文件名无效或访问被拒绝造成的。

注释

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

  • 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
};