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