JetIdle 関数

適用対象: Windows |Windows Server

JetIdle 関数は機能しず、テスト目的でのみ使用する必要があります。 JetIdle を使用すると、アイドル状態のクリーンアップタスクを実行したり、ESE のバージョンストアの状態をチェックしたりできます。

    JET_ERR JET_API JetIdle(
      __in          JET_SESID sesid,
      __in          JET_GRBIT grbit
    );

sesid

この呼び出しに使用されるセッション。

grbit

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

値	説明
JET_bitIdleCompact	バージョンストアのクリーンアップをトリガーします。
JET_bitIdleFlushBuffers	将来利用するために予約されています。このフラグを指定すると、API はJET_errInvalidgrbitを返します。
JET_bitIdleStatus	バージョンストアが半分を超える場合は、JET_wrnIdleFullを返します。

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

リターンコード	説明
JET_errSuccess	操作は正常に完了しました。
JET_errInvalidParameter	API に提供された grbit パラメーターが無効でした。

この関数が成功した場合は、適切な操作がトリガーされるか、指定された grbit に応じてバージョンストアがいっぱいであることを示すエラーコードがトリガーされます。

この関数が失敗した場合、要求された操作は正常に完了しません。

バージョンストアは、ESE のスナップショット分離メカニズムを維持します。バージョンストアがいっぱいの場合、プログラムは実行時間の長いトランザクションを閉じる可能性があります。実行時間の長いトランザクションがバージョンストアを使い果たすと、ESE はデータベースへの書き込み操作の許可を停止します。

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

フィードバック