JetInit2 関数

適用対象: Windows |Windows Server

JetInit2 関数

JetInit2 関数を使用すると、データベース エンジンはデータベース ファイルのアプリケーション使用をサポートできる状態になります。 エンジンは、 JetSetSystemParameter を使用した初期化用に既に適切に構成されている必要があります。 データベース クラッシュ復旧は、初期化プロセスの一環として自動的に実行されます。

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

この関数は、現在使用されていません。 代わりに JetInit3 を使用してください。

JET_ERR JET_API JetInit2(
  __in_out_opt  JET_INSTANCE* pinstance,
  __in          JET_GRBIT grbit
);

パラメーター

pinstance

この呼び出しに使用するインスタンス。

Windows 2000 の場合、このパラメーターは無視され、常に NULL である必要があります。

Windows XP 以降のリリースでは、このパラメーターの使用はエンジンの動作モードによって異なります。 1 つのインスタンスのみがサポートされているレガシ モード (Windows 2000 互換モード) でエンジンが動作している場合、このパラメーターは NULL であるか、NULL を含む有効な出力バッファーに設定されるか、初期化の副作用として作成されたグローバル インスタンス ハンドルを返すJET_instanceNilに設定できます。 このインスタンス ハンドルは、インスタンスを受け取る他の API に渡すことができます。 エンジンがマルチインスタンス モードで動作している場合、このパラメーターは、初期化中の JetCreateInstance によって返されるインスタンス ハンドルを含む有効な入力バッファーに設定する必要があります。

grbit

次のオプションの 0 個以上を指定するビットのグループ。

戻り値

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

解説

JetSetSystemParameter 以外で使用するには、インスタンスを JetInit2 の呼び出しで初期化する必要があります。

インスタンスが JetInit を使用して初期化されていなくても、JetTerm 関数の呼び出しによってインスタンスが破棄されます。 インスタンスは、データベース エンジンの回復可能性の単位です。 データベース ファイルのセット内のデータの整合性を保護するために使用されるすべてのファイルのライフ サイクルを制御します。 これらのファイルには、チェックポイント ファイルとトランザクション ログ ファイルが含まれます。

すべてのデータベースが存在しない一連のログ (通常の状況ではエラー JET_errAttachedDatabaseMismatchを返す) で復旧が実行されており、データベースが見つからない場合でもクライアントが復旧を続行する場合は、使用可能なデータベースの復旧を続行するために、JET_ bitReplayIgnoreMissingDB が使用されます。

詳細については、 JetInit の「解説」セクションを参照してください。

必要条件

参照

拡張可能なストレージ エンジン ファイル
JET_ERR
JET_GRBIT
JET_INSTANCE
JetCreateInstance
JetInit
JetInit3
JetSetSystemParameter
リソース パラメーター