JetCreateDatabase 関数

適用対象: Windows |Windows Server

JetCreateDatabase 関数

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

    JET_ERR JET_API JetCreateDatabase(
      __in          JET_SESID sesid,
      __in          JET_PCSTR szFilename,
      __in_opt      JET_PCSTR szConnect,
      __out         JET_DBID* pdbid,
      __in          JET_GRBIT grbit
    );

パラメーター

sesid

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

szFilename

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

szConnect

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

pdbid

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

grbit

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

値	説明
JET_bitDbOverwriteExisting	既定では、 JetCreateDatabase が呼び出され、データベースが既に存在する場合、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 によってデータベース ファイルが作成され、別のエラーが発生した場合は、クリーンされ、ファイルが削除されます。

JetCreateDatabase によって、データベースが暗黙的に開きます。 後で 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	JetCreateDatabaseW (Unicode) および JetCreateDatabaseA (ANSI) として実装されます。

参照

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