JetCreateDatabase2 関数

適用対象: Windows |Windows Server

JetCreateDatabase2 関数

JetCreateDatabase2 関数は、ESE データベース エンジンで使用するデータベース ファイルを作成し、最大データベース サイズを指定してアタッチします。 cpgDatabaseSizeMax を 0 に設定して JetCreateDatabase2 を呼び出すことは、szConnect が NULL に設定された JetCreateDatabase を呼び出すのと同じです。 現在、インスタンスごとに最大 7 つのデータベースを作成できます。

    JET_ERR JET_API JetCreateDatabase2(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in          const unsigned long cpgDatabaseSizeMax,
      __out         JET_DBID* pdbid,
      __in          JET_GRBIT grbit
    );

パラメーター

sesid

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

szFilename

作成するデータベースの名前です。

cpgDatabaseSizeMax

データベース の最大サイズ (データベース ページ)。 既定のデータベース ページ サイズは 4 キロバイトであり、データベースを作成する前に JetSetSystemParameter で変更できます。

0 を渡すと、データベース エンジンによって適用される最大値がないことを意味します。

pdbid

正常な呼び出し時にデータベースの識別子を含むバッファーへのポインター。 失敗した場合、値は未定義です。

grbit

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

値	説明
JET_bitDbOverwriteExisting	既定では、 JetCreateDatabase または JetCreateDatabase2 が呼び出され、データベースが既に存在する場合、API 呼び出しは失敗し、元のデータベースは上書きされません。 JET_bitDbOverwriteExistingこの動作が変更され、古いデータベースは新しいデータベースで上書きされます。 Windows XP 以降。
JET_bitDbRecoveryOff	JET_bitDbRecoveryOffはログ記録をオフにします。 このビットを設定すると、致命的なイベントの後にログ ファイルを再生し、データベースを一貫した使用可能な状態に回復する機能が失われます。
JET_bitDbShadowingOff	JET_bitDbShadowingOff設定すると、一部の内部データベース構造 (シャドウ) の重複が無効になります。 これらの構造体の重複は回復性のために行われるので、JET_bitDbShadowingOff設定すると、その回復性が削除されます。

戻り値

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

リターン コード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errDatabaseDuplicate	szFilename にという名前のデータベースが既に存在します。 このエラーが返されると、データベースはアタッチされません。
JET_errDatabaseInUse	排他アクセスが要求されたが、許可できなかった場合、または別のセッションが既にデータベースを排他的に開いている場合は、 を返すことができます。
JET_errDatabaseInvalidPages	cpgDatabaseSizeMax がデータベースで許可されているページの最大数より大きい場合に返されます。 現在の最大値は 2147483646 (0x7ffffffe) です。
JET_errDatabaseInvalidPath	szFilename に無効なパスが指定されました。 szFilename は NULL 以外である必要があります。 既定では、 szFilename は存在するディレクトリを指す必要があります。 JET_paramCreatePathIfNotExistが設定されている場合は、パスが作成されます (JetSetSystemParameter を参照)。
JET_errDatabaseLocked	別のセッションが既に (JET_bitDbExclusive を使用して) データベースを排他的に開いていることを示します。
JET_errDatabaseNotFound	データベースが以前にアタッチされていません ( 「JetAttachDatabase」を参照)。
JET_errDatabaseSharingViolation	データベース ファイルは既に別のセッションによってアタッチされています。
JET_errInTransaction	トランザクション中にデータベースを作成しようとしました。
JET_errInvalidDatabase	有効なデータベース ファイルではないファイルを開こうとしました。
JET_errOneDatabasePerSession	複数のデータベースを開こうとし、JET_paramOneDatabasePerSessionが設定されました。 「システム パラメーター」を参照してください。
JET_errOutOfMemory	リソースが不足していた。
JET_errTooManyAttachedDatabases	インスタンスごとにアタッチできるデータベースの数は限られています。 制限は現在、インスタンスあたり 7 つのデータベースです。
JET_wrnDatabaseAttached	データベース ファイルがこのセッションによって既にアタッチされていることを示す致命的でない警告。
JET_wrnFileOpenReadOnly	JET_wrnFileOpenReadOnlyは、ファイルが読み取り専用でアタッチされたが、 JetCreateDatabase がJET_bitDbReadOnlyを渡さなかったことを示します。 データベースは引き続き読み取り専用で開かれます。

注釈

szFilename で指定されたデータベースが存在し、JET_bitDbOverwriteExistingが渡されなかった場合、API 呼び出しは失敗します。 JET_bitDbOverwriteExistingが渡された場合、最初に古いデータベース ファイルが削除されます。

API によってデータベース ファイルが作成され、別のエラーが発生した場合は、クリーンされ、ファイルが削除されます。

JetCreateDatabase2 は、データベースを暗黙的に開きます。 後で JetOpenDatabase を呼び出す必要はありません。

要件

要件	値
Client	Windows Vista、Windows XP、または Windows 2000 Professional が必要です。
[サーバー]	Windows Server 2008、Windows Server 2003、または Windows 2000 Server が必要です。
Header	Esent.h で宣言されています。
Library	ESENT.lib を使用します。
[DLL]	ESENT.dllが必要です。
Unicode	JetCreateDatabase2W (Unicode) および JetCreateDatabase2A (ANSI) として実装されます。

参照

拡張可能なストレージ エンジン ファイル
JET_ERR
JET_DBID
JET_GRBIT
JET_SESID
JetAttachDatabase
JetCloseDatabase
JetCreateDatabase
JetOpenDatabase
JetSetSystemParameter
システム パラメーター