JetGetRecordPosition 関数

適用対象: Windows |Windows Server

JetGetRecordPosition 関数

JetGetRecordPosition 関数は、現在のインデックス内の現在のレコードの小数位置を、JET_RECPOS構造体の形式で返します。 この構造体は、現在のレコードの前のインデックス エントリのおおよその数と、インデックス内のエントリのおおよその合計数の観点から小数部の位置を記述します。

    JET_ERR JET_API JetGetRecordPosition(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __out         JET_RECPOS* precpos,
      __in          unsigned long cbRecpos
    );

パラメーター

sesid

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

tableid

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

precpos

現在のインデックス内の現在のレコードの位置を取得するために使用する分数の説明。

cbRecpos

precpos で割り当てられたメモリのサイズ。

戻り値

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

成功すると、インデックス内の現在のレコードの前にあるインデックス エントリのおおよその数が precpos-centriesLT> で返されます。 1 は precpos-centriesInRange> で返されます。 インデックス内のエントリのおおよその数は precpos-centriesTotal> で返されます。

障害が発生した場合、 事前に割り当てられたメモリに対する変更は行われません。

解説

この操作では、テーブルで更新が継続的に行われると、さまざまなデータが返されます。 値の変更は、インデックスの物理プロパティに基づく近似値であるため、更新に関する知識に基づく期待値と常に一致するとは限りません。 トランザクション分離は JetGetRecordPosition からの位置には適用されません。値は、トランザクション分離されていないインデックスの物理プロパティに依存するためです。

JET_RECPOS は、テーブル内のレコードを記述したり、既存のレコードに近いレコードの位置を変更したりするために使用しないでください。 代わりに、既存のレコードのブックマークを取得してから、同じレコードの位置を変更するために使用する必要があります。

要件

参照

JET_COLUMNID
JET_ERR
JET_SESID
JET_TABLEID
JET_RECPOS
JET_SETINFO
JetGotoPosition
JetStopService