CRecordset::GetStatus

更新 : 2007 年 11 月

レコードセット内の現在のレコードのインデックスや、最終レコードが認識されているかどうかを調べます。

void GetStatus(
   CRecordsetStatus& rStatus 
) const;

パラメータ

  • rStatus
    CRecordsetStatus オブジェクトへの参照。詳細については、次の「解説」を参照してください。

解説

CRecordset はインデックスを監視しようとしていますが、監視できない場合もあります。その理由については、「CRecordset::GetRecordCount」を参照してください。

CRecordsetStatus 構造体の形式を次に示します。

struct CRecordsetStatus

{

long m_lCurrentRecord;

BOOL m_bRecordCountFinal;

};

CRecordsetStatus の 2 つのメンバの意味を次に示します。

  • m_lCurrentRecord   レコードセットの現在のレコードのインデックスがわかっていれば、0 から開始するインデックスとして保持します。インデックスがわからないときは、AFX_CURRENT_RECORD_UNDEFINED (-2) を保持します。IsBOFTRUE (レコードセットが空、または先頭レコードより前にスクロールしようとした) のとき、m_lCurrentRecordAFX_CURRENT_RECORD_BOF (-1) に設定されます。先頭レコードのときは 0、2 番目のときは 1 というようにセットされます。

  • m_bRecordCountFinal   レコードセットのレコードの総数がわかっているときは 0 以外になります。通常レコードの総数は、レコードセットの先頭から IsEOF が 0 以外を返すまで、MoveNext 関数を繰り返し呼び出すことによって数えられます。このメンバが 0 で、GetRecordCount が返すレコード数が -1 でないときは、返されるレコード数はレコードの "最高水位線" でしかありません。

必要条件

ヘッダー : afxdb.h

参照

参照

CRecordset クラス

階層図

CRecordset::GetRecordCount

その他の技術情報

CRecordset のメンバ