JetDetachDatabase 関数

適用対象: Windows |Windows Server

JetDetachDatabase 関数

JetDetachDatabase 関数は、以前にデータベース セッションにアタッチされていたデータベース ファイルを解放します。

    JET_ERR JET_API JetDetachDatabase(
      __in          JET_SESID sesid,
      __in          const tchar* szFilename
    );

パラメーター

sesid

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

szFilename

デタッチするデータベースの名前。 szFilename が NULL または空の文字列の場合、sesid にアタッチされているすべてのデータベースがデタッチされます。

戻り値

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

リターン コード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errBackupInProgress	データベースはバックアップ中であり、デタッチできません。
JET_errDatabaseInUse	データベースは JetOpenDatabase によって開かれています。 デタッチする前にデータベースを閉じる必要があります。
JET_errDatabaseNotFound	データベースが以前にアタッチされていません ( JetAttachDatabase または JetAttachDatabase2 を参照)。
JET_errInTransaction	トランザクション中にデータベースをデタッチしようとしました。

解説

アタッチされたデータベースが ( JetAttachDatabase を使用して) 開かれた場合は、デタッチする前に JetCloseDatabase で閉じる必要があります。

Windows 2000 のみ: JetTerm を呼び出す前にデタッチされていないデータベースは、 JetInit が次に呼び出されたときに自動的に再アタッチされます。

必要条件

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

参照

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetAttachDatabase
JetAttachDatabase2
JetCreateDatabase
JetCreateDatabase2
JetCloseDatabase
JetTerm