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