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 は、無効なファイル名やアクセスの拒否によって発生します。

2 セットのパラメーターで指定される情報を使用してデータベースが作成されます。

connect_parms パラメーターは、データベースがアクセスされるたびに適用される接続パラメーターのリストです。ファイル名、ユーザー ID、パスワード、オプションの暗号化キーは、その例です。

create_parms パラメーターはパラメーターのリストで、データベースの作成時にのみ意味を持ちます。難読化、ページサイズ、時間形式や日付形式は、その例です。

アプリケーションでこのメソッドを呼び出すことができるのは、SQLCA の初期化後です。

次のコードは、ULCreateDatabase メソッドを使用して、ファイル C:\myfile.udb に Ultra Light データベースを作成する方法を示します。

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 メソッド

構文

パラメーター

戻り値

備考

参照