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

ul_true if database was successfully created or ul_false if it the creation was unsuccessful. Typically ul_false is caused by an invalid file name or access denial.

The database is created with information provided in two sets of parameters.

The connection-parms are standard connection parameters that are applicable whenever the database is accessed (for example, file name, user id, password, optional encryption key, and so on).

The creation-parms are parameters that are only relevant when creating a database (for example, obfuscation,page-size, time and date format, and so one). Applications can call this function after initializing the SQLCA.

The following code illustrates using ULCreateDatabase to create an UltraLite database as the file C:\myfile.udb :

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