JetAttachDatabase 関数

適用対象: Windows |Windows Server

JetAttachDatabase 関数

JetAttachDatabase 関数は、データベース インスタンスで使用するデータベース ファイルをアタッチします。 データベースを使用するには、その後 JetOpenDatabase を使用してデータベースを開く必要があります。

    JET_ERR JET_API JetAttachDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          JET_GRBIT grbit
    );

パラメーター

sesid

API 呼び出しに使用するデータベース セッション コンテキスト。

szFilename

アタッチするデータベースの名前。

grbit

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

戻り値

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

解説

JetAttachDatabase の呼び出しは、JetAttachDatabase2 を呼び出し、値 0 を渡すことと同じです。つまり、cpgDatabaseSizeMax パラメーターに制限はありません。

書き込み可能なデータベースをアタッチすると (つまり、 grbit パラメーターでJET_bitDbReadOnlyが指定されていない場合)、オペレーティング システム レベルでのみファイルが開きます。 他のプロセスではファイルを開くことができません。 複数のプロセスで 1 つのデータベースを読み取り専用モードで開くことで、1 つのデータベースをアタッチできます。

データベース ファイルは、 JetDetachDatabase または JetDetachDatabase2 を使用してデタッチされます。

インデックス チェック パラメーター

Windows の異なるバージョンでは、さまざまな方法で Unicode テキストが正規化されます。 つまり、1 つのバージョンの Windows でビルドされたインデックスは、他のバージョンでは機能しない可能性があります。

Windows Server 2003 より前では、オペレーティング システムのバージョンが変更されたとき (Service Pack のインストールを含む)、Unicode データに対するすべてのインデックスが破損している可能性がありました。

Windows Server 2003 以降で作成されたインデックスには、作成された Unicode 正規化のバージョンでフラグが設定されます。 古いインデックスにはバージョン情報が含まれない。 Unicode 正規化のほとんどの変更は、新しい文字を追加することで構成され、以前は未定義だったコード ポイントが定義され、異なる方法で正規化されるようになりました。 したがって、バイナリ データが Unicode 列に格納されている場合、新しいコード ポイントが定義されると、異なる方法で正規化されます。

Windows Server 2003 の時点で、ESE データベース エンジンは、未定義のコード ポイントを含む Unicode インデックス エントリを追跡します。 これらは、定義された Unicode 文字のセットが変更されたときにインデックスを修正するために使用できます。

これらのパラメーターは、ESE データベース エンジンが、オペレーティング システムの別のビルドで最後に使用されたデータベースにアタッチした場合の動作を制御します。 オペレーティング システムのバージョンは、データベース ヘッダーにスタンプされます。

JET_paramEnableIndexCheckingが TRUE に設定されていて、データベースに破損している可能性があるインデックスが含まれている場合:

• grbit に JET_bitDbDeleteCorruptIndexesが含まれている場合、JetAttachDatabase は破損している可能性のあるインデックスを削除します

• grbit にJET_bitDbDeleteCorruptIndexesが含まれていない場合、削除が必要なインデックスがある場合、JetAttachDatabaseはエラーを返します。

JET_paramEnableIndexCheckingが FALSE に設定されている場合:

• JetAttachDatabase は、破損している可能性のあるインデックスを無視し、JET_errSuccessを返します (他のエラーがなかった場合)。

Windows Server 2003 以降: JET_paramEnableIndexChecking がリセットされていない場合は、内部修正テーブルを使用してインデックス エントリを修正します。 これにより、すべてのインデックスの破損が修正されるわけではありませんが、アプリケーションに対して透過的になります。

データベースが読み取り専用としてアタッチされている場合、インデックスを固定または削除することはできません。 この場合、API は代わりに、JET_errSecondaryIndexCorruptedやJET_errPrimaryIndexCorruptedなどのエラーを返します。

要件

参照

拡張可能なストレージ エンジン ファイル
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase2
JetCreateDatabase
JetDetachDatabase
JetDetachDatabase2
JetOpenDatabase
JetSetSystemParameter