JetStopService 関数

適用対象: Windows |Windows サーバー

JetStopService 関数

JetStopService 関数は、インスタンスを終了する準備をします。

JetStopService は、インスタンスが 1 つだけ許可されている場合のレガシ呼び出しです。 この場合、アクティブなインスタンスは終了の準備をしているインスタンスだけです。

    JET_ERR JET_API JetStopService(void);

パラメーター

この関数にはパラメーターはありません。

戻り値

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

リターン コード

説明

JET_errSuccess

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

JET_errRunningInMultiInstanceMode

複数のインスタンス モードで JetStopService を使用する場合、終了の準備をするインスタンスが明確ではありません。

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

この関数が成功すると、将来の終了の準備が行われます。 終了の準備に必要な手順は次のとおりです。

  • オンライン最適化が実行されている場合は停止します。

  • バージョン ストアのクリーンアップを開始します。

  • バッファー マネージャーでダーティ ページのフラッシュを開始して、チェックポイントの深さを減らします。

  • そのインスタンスのほとんどの関数に対する今後の呼び出しを防止します。

この関数が失敗した場合、インスタンスの終了を準備する手順は実行されないため、インスタンスの状態に対する変更は行われません。

注釈

この関数は、インスタンスが終了したときに実行する必要がある作業を減らしますが、インスタンスは終了しません。 その結果、この関数は単なる最適化であり、使用することは必須ではありません。 準備で行われた作業の量は、Windows 2000とWindows XPで少なかったことに注意してください。 関数が成功すると、許可されなくなった関数を呼び出すと、JET_errClientRequestToStopJetServiceが返されます。 この呼び出し後も引き続き許可される関数は、 JetRollbackJetCloseTableJetEndSessionJetCloseDatabaseJetDetachDatabaseJetResetSessionContext です。

要件

要件

Client

Vista、Windows XP、または 2000 Professional Windows Windows必要です。

[サーバー]

Windows Server 2008、Windows Server 2003、または Windows 2000 Server が必要です。

ヘッダー

Esent.h で宣言されています。

Library

ESENT.lib を使用します。

[DLL]

ESENT.dllが必要です。

参照

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2