次の方法で共有

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_bitReplayReplicatedLogFiles

将来利用するために予約されています。

JET_bitCreateSFSVolumeIfNotExist

将来利用するために予約されています。

JET_bitReplayIgnoreMissingDB

このオプションを使用すると、すべてのデータベースが存在せず、ログ セットの 1 つのポイントにアタッチされた一連のログ ファイルに対して回復を実行できます。

JET_bitRecoveryWithoutUndo

回復を実行しますが、元に戻すフェーズでは停止します。 これにより、追加のトランザクション ログを にコピーして適用できます。

JET_bitTruncateLogsAfterRecovery

回復が正常に完了したら、ログ ファイルを切り捨てます。

JET_bitReplayMissingMapEntryDB

データベース マップ エントリが見つからない場合、既定では同じ場所になります。

JET_bitReplayIgnoreLostLogs

ログ ストリームの末尾から失われたログを無視します。

Windows 7:JET_bitReplayIgnoreLostLogs は Windows 7 で導入されています。

戻り値

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

解説

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

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

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

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

必要条件

要件 値

Client

Windows Vista または Windows XP が必要です。

[サーバー]

Windows Server 2008 または Windows Server 2003 が必要です。

Header

Esent.h で宣言されています。

Library

ESENT.lib を使用します。

[DLL]

ESENT.dllが必要です。

参照

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