JetTerm2 関数

  • [アーティクル]

適用対象: Windows |Windows Server

JetTerm2 関数

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

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

    JET_ERR JET_API JetTerm2(
      __in          JET_INSTANCE instance,
      __in          JET_GRBIT grbit
    );

パラメーター

instance

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

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

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

grbit

この呼び出しに使用するオプションを含むビットのグループ。0 個以上の値が含まれます。

値

説明

JET_bitTermComplete

インスタンスをクリーンにシャットダウンすることを要求します。 通常、実行時にバックグラウンドで行われる任意のクリーンアップ作業は、すぐに完了します。

JET_bitTermAbrupt

インスタンスをできるだけ迅速にシャットダウンするように要求します。 通常、実行時にバックグラウンドで実行される任意の作業は破棄されます。

メモ このオプションを選択すると、データベースの一時的または永続的な領域が失われる可能性があります。 この失われた領域は、データベースのオフライン最適化によって常に復旧できます。

JET_bitTermStopBackup

現在進行中のバックアップがある場合でも、インスタンスをシャットダウンすることを要求します。 通常、保留中のバックアップでは、 JetTerm がJET_errBackupInProgressで失敗します。 このパラメーターが存在しない場合、その値はJET_bitTermAbruptと見なされます。

JET_bitTermDirty

アタッチされているすべてのデータベースをダーティ状態のままにしてインスタンスをシャットダウンすることを要求します。

Windows 7: JET_bitTermDirtyは Windows 7 で導入されています。

戻り値

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

リターン コード

説明

JET_errSuccess

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

JET_errBackupInProgress

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

JET_errInvalidParameter

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

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

JET_errNotInitialized

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

JET_errTermInProgress

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

JET_errRestoreInProgress

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

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
JetTerm