JetStopService 関数

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

JetStopService 関数

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

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

    JET_ERR JET_API JetStopService(void);

パラメーター

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

戻り値

この関数は、次 JET_ERR のいずれかの戻りコードを持つデータ型を返します。 考えられる ESE エラーの詳細については、「 Extensible Storage Engine Errors 」および「エラー処理パラメーター 」を参照してください

リターン コード

説明

JET_errSuccess

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

JET_errRunningInMultiInstanceMode

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

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

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

  • 実行中の場合は、オンライン最適化を停止します。

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

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

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

この関数が失敗した場合、インスタンスの終了に備える手順は実行されません。そのため、インスタンスの状態を変更する必要はありません。

解説

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

必要条件

要件

Client

Vista Windows XP、Windows 2000 Windows が必要Professional。

サーバー

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

Header

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

Library

ESENT.lib を使用します。

[DLL]

必要ESENT.dll。

参照

JET_ERR
JET_INSTANCE
JetCloseDatabase
JetCloseTable
JetDetachDatabase
JetEndSession
JetResetSessionContext
JetRollback
JetTerm
JetTerm2