EssCreateApplicationEx

クライアントまたはサーバー上で、新規アプリケーションを作成します。アプリケーションがサーバーで作成された場合は、起動も行われます。この関数は、Unicodeモードのアプリケーションを作成できます。

構文

            
ESS_FUNC_M EssCreateApplicationEx(
            hCtx
            , 
            AppName
            , 
            usAppType
            );

パラメータ	データ型	説明
hCtx	ESS_HCTX_T	APIコンテキスト・ハンドル。
AppName	ESS_STR_T	作成するアプリケーションの名前。アプリケーション名の制限を参照してください。
usAppType		新規アプリケーションのアプリケーション・タイプ(Unicodeまたは非Unicode)。有効な値は次のとおりです: ESS_APP_UNICODE - 0x0003 - Unicodeアプリケーションを作成します。サーバーがUnicodeモードでない場合、関数は失敗します。 ESS_APP_NONUNICODE - 0x0002 - 非Unicodeアプリケーションを作成します。

パラメータ

データ型

説明

hCtx

ESS_HCTX_T

APIコンテキスト・ハンドル。

AppName

ESS_STR_T

作成するアプリケーションの名前。アプリケーション名の制限を参照してください。

usAppType

新規アプリケーションのアプリケーション・タイプ(Unicodeまたは非Unicode)。

有効な値は次のとおりです:

ESS_APP_UNICODE - 0x0003 - Unicodeアプリケーションを作成します。サーバーがUnicodeモードでない場合、関数は失敗します。
ESS_APP_NONUNICODE - 0x0002 - 非Unicodeアプリケーションを作成します。

備考

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

戻り値

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

アクセス

サーバー・アプリケーションの場合、呼出し元はアプリケーションの作成/削除/編集権限(ESS_PRIV_APPCREATE)を持っている必要があります。