JetResetTableSequential 関数

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

JetResetTableSequential 関数

JetResetTableSequential 関数は、アプリケーションが特定のカーソルを含む現在のインデックス全体をスキャンしなくなったことをデータベース エンジンに通知します。 この呼び出しは、 JetSetTableSequential によって送信された通知を逆にします。

Windows XP:JetResetTableSequential は、Windows XP で導入されています。

    JET_ERR JET_API JetResetTableSequential(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_GRBIT grbit
    );

パラメーター

sesid

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

tableid

この呼び出しに使用するカーソル。

grbit

将来利用するために予約されています。

戻り値

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

リターン コード

説明

JET_errSuccess

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

JET_errClientRequestToStopJetService

JetStopService の呼び出しの結果、セッションに関連付けられているインスタンス上のすべてのアクティビティが停止したため、操作を完了することはできません。

JET_errInstanceUnavailable

セッションに関連付けられているインスタンスで致命的なエラーが発生したため、操作を完了することはできません。このエラーでは、そのデータの整合性を保護するためにすべてのデータへのアクセスを取り消す必要があります。 このエラーは、Windows XP 以降のリリースでのみ返されます。

JET_errNotInitialized

セッションに関連付けられているインスタンスがまだ初期化されていないため、操作を完了できません。

JET_errRestoreInProgress

セッションに関連付けられているインスタンスで復元操作が進行中であるため、操作を完了できません。

JET_errTermInProgress

セッションに関連付けられているインスタンスがシャットダウンされているため、操作を完了できません。

成功すると、カーソルの現在のインデックスは、インデックス全体のシーケンシャル スキャン用に最適化されなくなりました。 データベースの状態に対する変更は行われません。

失敗した場合、カーソルの構成は変更されません。 データベースの状態に対する変更は行われません。

解説

JetSetTableSequential の呼び出しによって以前に構成されていないカーソルに対してこの呼び出しを行うのは安全です。

要件

要件

Client

Vista または Windows XP Windows必要です。

[サーバー]

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

ヘッダー

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

Library

ESENT.lib を使用します。

[DLL]

ESENT.dllが必要です。

参照

JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetSetTableSequential
JetStopService