JetOpenDatabase 関数

適用対象: Windows |Windows Server

JetOpenDatabase 関数

JetOpenDatabase 関数は、データベース セッションで使用するために JetAttachDatabase 関数または JetAttachDatabase2 関数を使用して、以前にアタッチされたデータベースを開きます。 この関数は、同じデータベースに対して複数回呼び出すことができます。

    JET_ERR JET_API JetOpenDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename,
      __in_opt      const tchar* szConnect,
      __out         JET_DBID* pdbid,
      __in          JET_GRBIT grbit
    );

パラメーター

sesid

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

szFilename

開くデータベースの名前。

szConnect

予約済み。 NULL に設定されている。

pdbid

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

grbit

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

値	説明
JET_bitDbExclusive	データベースのアタッチを許可するセッションは 1 つだけです。 通常、複数のセッションでデータベースを開くことができます。
JET_bitDbReadOnly	データベースの変更を防止します。

戻り値

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

リターン コード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errDatabaseInUse	排他アクセスが要求されましたが、許可できませんでした。
JET_errDatabaseInvalidPath	szFilename に無効なパスが指定されました。 szFilename は NULL 以外で、有効なファイルを参照する必要があります。
JET_errDatabaseLocked	別のセッションが既にデータベースを排他的に開いています (JET_bitDbExclusiveを使用)。
JET_errDatabaseNotFound	データベースが以前にアタッチされていません ( 「JetAttachDatabase」を参照)。
JET_errInvalidDatabase	有効なデータベース ファイルではないファイルを開こうとしました。
JET_errOneDatabasePerSession	複数のデータベースを開こうとし、 JET_paramOneDatabasePerSession が設定されました。 詳細については、「 システム パラメーター」を参照してください。
JET_wrnFileOpenReadOnly	ファイルは読み取り専用としてアタッチされましたが、 JetOpenDatabase はJET_bitDbReadOnlyを渡しませんでした。 データベースは引き続き読み取り専用で開かれます。

必要条件

要件	値
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	JetOpenDatabaseW (Unicode) および JetOpenDatabaseA (ANSI) として実装されます。

参照

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetSetSystemParameter
システム パラメーター