EssCreateDatabaseEx

クライアントまたはサーバー上で、アプリケーション内に新規データベースを作成します。データベースがサーバー上で作成された場合、起動も行われます。この関数は、重複しているメンバー名をサポートしているデータベースの作成に使用されます。

構文

            ESS_FUNC_M EssCreateDatabaseEx (
            hCtx, AppName, DbName, DbType, bNonUniqueName 
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
AppName	ESS_STR_T	データベースを含むアプリケーションの名前。
DbName	ESS_STR_T	作成するデータベースの名前。データベース名の制限を参照してください。
DbType	ESS_USHORT_T	作成するデータベースのタイプ。ESS_DBTYPE_NORMALまたはESS_DBTYPE_CURRENCY
bNonUniqueName	ESS_BOOL_T	TRUEに設定すると、この関数は重複したメンバー名に対応したアウトラインを含むデータベースを作成します。FALSEに設定すると、EssCreateDatabaseと同様に機能します。

備考

クライアント・データベースを作成すると、ローカル・データベース・ファイルを含むディレクトリが作成されます。
新規作成されたデータベースやアプリケーションは自動的にアクティブに設定されません。EssCreateDatabase、EssCreateDatabaseExまたはEssCreateApplicationを呼び出した後でEssSetActiveを呼び出し、EssRestructureなどの以降の関数が間違ったデータベースやアプリケーション(アクティブなアプリケーションまたはデータベース)に対して実行されないようにします。

戻り値

正常終了の場合は0が戻され、それ以外はエラーが戻されます。

アクセス

サーバー・データベースの場合は、呼出し元がデータベースの作成/削除/編集権限(ESS_PRIV_DBCREATE)を持っている必要があります。

例

         ESS_FUNC_M ESS_CreateDb()
{
   ESS_STS_T sts = ESS_STS_NOERR;
   ESS_STR_T AppName;
   ESS_STR_T DbName;
   
   AppName = "Sample";
   DbName = "Basic";
   sts = EssCreateDatabaseEx(hCtx, AppName, DbName, ESS_DBTYPE_NORMAL, TRUE);
   
   return (sts);
   
}