次の方法で共有


CRecordset::SetRowsetCursorPosition

現在の行セット内の行にカーソルを移動します。

void SetRowsetCursorPosition(
   WORD wRow,
   WORD wLockType = SQL_LOCK_NO_CHANGE 
);

パラメーター

  • wRow
    現在の行セットの 1 行目ベースの位置。この値は、1 から行セットのサイズまでです。

  • wLockType
    更新された後に行をロックする方法を示す値。詳細については、「解説」を参照してください。

解説

バルク行フェッチを実装する場合、レコード行セットがフェッチの最初のレコードが現在のレコードの行セットによって取得されます。行セット内の個別のレコードが現在のレコードを行うには、SetRowsetCursorPositionを呼び出します。たとえば、GetFieldValue のメンバー関数と動的に、レコードセットの各レコードからデータを取得するに SetRowsetCursorPosition を結合できます。

SetRowsetCursorPositionを使用するには、[開く] のメンバー関数で dwOptions のパラメーターの CRecordset::useMultiRowFetch のオプションを指定することで、バルク行フェッチを実装している必要があります。

SetRowsetCursorPositionSQLSetPosは、ODBC API 関数を呼び出します。wLockType のパラメーターは SQLSetPos を実行すると行のロック状態を指定します。次の表は wLockType.のできる値を示します。

wLockType

説明

SQL_LOCK_NO_CHANGE (既定)

行が SetRowsetCursorPosition が呼び出される前に設定された同じロックまたはロック解除状態にあることをドライバーまたはデータ ソースが保証されます。

SQL_LOCK_EXCLUSIVE

ドライバーまたはデータ ソースは行の排他的ロックします。すべてのデータ ソースがロックのこの型をサポートしません。

SQL_LOCK_UNLOCK

ドライバーまたはデータ ソースは、行のロックを解除します。すべてのデータ ソースがロックのこの型をサポートしません。

SQLSetPosに関する詳細については、Windows SDKを参照してください。バルク行フェッチに関する詳細については、" " レコードセット: フェッチ サイズのレコードを (ODBC)を参照してください。

必要条件

Header: afxdb.h

参照

関連項目

CRecordset クラス

階層図

CRecordset::RefreshRowset

CRecordset::SetRowsetSize