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

ul_true if database was successfully created; otherwise, returns ul_false. Typically ul_false is caused by an invalid file name or denied access.

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

The connect_parms parameter is a list of connection parameters that are applicable whenever the database is accessed. Some examples include file name, user ID, password, or optional encryption key.

The create_parms parameter is a list of parameters that are only relevant when creating a database. Some examples include obfuscation, page-size, and time and date format).

Applications can call this method after initializing the SQLCA.

The following code illustrates how to use the ULCreateDatabase method 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
};

• UltraLite connection parameters
• UltraLite creation parameters