ULCreateDatabaseW method

public ul_bool ULCreateDatabaseW(
    SQLCA * sqlca,
    ul_wchar const * connect_parms,
    ul_wchar const * create_parms,
    void * reserved
)

sqlca A pointer to the initialized SQLCA.
connect_parms A semicolon separated string of connection parameters, which are set as keyword value pairs. The connection string must include the name of the database. These parameters are the same set of parameters that may be specified when you connect to a database.
create_parms A semicolon separated string of database creation parameters, which are set as keyword value pairs. For example: page_size=2048;obfuscate=yes.
reserved This parameter is reserved for future use.

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.

Note

This method prototype is used internally when you refer to ULCreateDatabase and #define the UNICODE macro on Win32 platforms. Typically, you would not reference this method directly when creating an UltraLite application.

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

ULCreateDatabaseW method

Syntax

Parameters

Returns

Remarks

Note