JetStopService 関数

適用対象: Windows |Windows Server

JetStopService 関数

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

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

    JET_ERR JET_API JetStopService(void);

パラメーター

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

戻り値

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

リターン コード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errRunningInMultiInstanceMode	複数のインスタンス モードで JetStopService を使用する場合、終了の準備をするインスタンスは明確ではありません。 Windows XP: この戻り値は Windows XP で導入されています。

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

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

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

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

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

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

解説

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

必要条件

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

参照

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2