JetEnableMultiInstance 関数

適用対象: Windows |Windows Server

JetEnableMultiInstance 関数

JetEnableMultiInstance 関数は、同じプロセス内の複数のインスタンスで使用するようにデータベース エンジンを構成します。 グローバル システム パラメーターの省略可能な配列は、マルチインスタンス モードへの変更を許可する最初の呼び出し元で使用できます。

Windows XP: JetEnableMultiInstance は Windows XP で導入されています。

    JET_ERR JET_API JetEnableMultiInstance(
      __in_opt      JET_SETSYSPARAM* psetsysparam,
      __in_opt      unsigned long csetsysparam,
      __out_opt     unsigned long* pcsetsucceed
    );

パラメーター

psetsysparam

この呼び出しの結果としてエンジンがマルチインスタンス モードに入った場合にのみ設定するグローバル システム パラメーターの配列。 csetsysparam が 0 の場合、psetsysparam は無視されます。

csetsysparam

この呼び出しの結果としてエンジンがマルチインスタンス モードに入った場合にのみ設定するグローバル パラメーターの配列の要素の数。 csetsysparam が 0 の場合、psetsysparam は無視されます。

pcsetsucceed

この呼び出しの結果として正常に構成されたグローバル システム パラメーターの数へのポインター。

戻り値

この関数は、次のいずれかの戻りコードを 使用して、JET_ERR データ型を返します。 考えられる ESE エラーの詳細については、「 拡張ストレージ エンジン エラー と エラー処理パラメーター」を参照してください。

この関数が成功した場合、データベース エンジンはマルチインスタンス モードで実行するように構成されます。 また、グローバル システム パラメーターのオプションリストを使用してエンジンが正常に構成されました。

この関数が失敗した場合、データベース エンジンは現在のモードのままです。 pcsetsucceed が 0 以外の場合、そのシステム パラメーターの数は設定されたままになります。

解説

この関数は、同じプロセスでマルチユーザー シナリオで使用するようにデータベース エンジンを設定するときに、アプリケーションで特定のシステム パラメーターセットをアトミックに構成する必要がある場合にのみ使用する必要があります。 同期の別の方法が使用可能な場合は、 JetCreateInstance と JetSetSystemParameter を 個別に呼び出す方が望ましいです。

要件

参照

JET_ERR
JET_SETSYSPARAM
JetCreateInstance
JetInit
JetSetSystemParameter