次の方法で共有


JetTerm 関数

適用対象: Windows |Windows Server

JetTerm 関数

JetTerm 関数は、JetInit によって初期化されたインスタンスのシャットダウンを開始します。

JetTerm を使用して、 JetCreateInstance によって作成された初期化されていないインスタンスを破棄することもできます。

    JET_ERR JET_API JetTerm(
      __in          JET_INSTANCE instance
    );

パラメーター

instance

この呼び出しに使用するインスタンスを指定します。

Windows 2000: このパラメーターは無視され、常に NULL にする必要があります。

Windows XP 以降のリリース: このパラメーターはオーバーロードされています。 1 つのインスタンスのみがサポートされているレガシ モード (Windows 2000 互換モード) でエンジンが動作している場合、このパラメーターは NULL であるか、 JetInit によって返される実際のインスタンスが含まれている可能性があります。 エンジンがマルチインスタンス モードで動作している場合、このパラメーターは JetCreateInstance を使用して作成されたインスタンスへのポインターである必要があります。

戻り値

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

リターン コード

説明

JET_errSuccess

操作は正常に完了しました。

JET_errInvalidParameter

指定されたパラメーターの 1 つに予期しない値が含まれていたか、複数のパラメーターの組み合わせによって予期しない結果が発生しました。 このエラーは、エンジンがマルチインスタンス モードの場合、および pinstance が無効なインスタンスを参照している場合に、JetTerm によって返されます。

Windows XP: この戻り値は Windows XP で導入されています。

JET_errNotInitialized

インスタンスがまだ初期化されていないため、操作を完了できません。

JET_errTermInProgress

インスタンスがシャットダウンされているため、操作を完了できません。

JET_errRestoreInProgress

インスタンスで復元操作が進行中であるため、操作を完了できません。

JET_errBackupInProgress

インスタンスでバックアップ操作が進行中のため、操作を完了できません。

JET_errTooManyActiveUsers

指定したインスタンスに対してアクティブなトランザクションを持つセッションが現在存在するため、インスタンスをシャットダウンできません。 このエラーは、JET_bitTermCompleteが使用されている場合にのみ発生します。

この関数が成功すると、指定したインスタンスがシャットダウンされます。 インスタンス ハンドルも閉じられ、インスタンス ハンドルを受け取る API では使用できなくなります。 セッションなど、インスタンスに関連付けられている他のすべてのオブジェクトも閉じられます。 チェックポイント ファイル、トランザクション ログ ファイル、およびインスタンスにアタッチされているデータベース ファイルの状態は、シャットダウン プロセス中に変更されます。

使用エラーの結果としてこの関数が失敗した場合、インスタンスは初期化された状態のままであり、何も変更されません。 それ以外の場合、インスタンスは成功したケースに従ってシャットダウンされます。 違いは、インスタンスが次に初期化されるときにクラッシュ復旧を実行する必要があるということです。 エンジンは、必要な回復量を最小限に抑えるために、できるだけ多くのデータをフラッシュしようとします。 概念的には、 JetTerm のこのようなエラーは、プロセスのクラッシュと同じでもありません。

解説

インスタンスで JetTerm が正常に呼び出される前に、インスタンスのホスト プロセスが何らかの理由で終了した場合、インスタンスはクラッシュ状態と見なされます。 クラッシュ復旧は、次にそのインスタンスを初期化しようとしたときに発生します。

要件

要件

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が必要です。

参照

拡張可能なストレージ エンジン ファイル
JetCreateInstance
JET_ERR
JET_GRBIT
JetInit
JET_INSTANCE
JetTerm2