CRecordset::SetRowsetCursorPosition
Mueve el cursor a una fila en el conjunto de filas actual.
void SetRowsetCursorPosition(
WORD wRow,
WORD wLockType = SQL_LOCK_NO_CHANGE
);
Parámetros
wRow
La posición basada en uno de una fila en el conjunto de filas actual.Este valor puede variar del 1 al tamaño del conjunto de filas.wLockType
valor que indica cómo bloquear la fila después de que se haya actualizado.Para obtener detalles, vea las notas.
Comentarios
Al implementar la obtención masiva de filas, los registros se recuperan mediante conjuntos de filas, donde es el registro actual el primer registro del conjunto de filas capturado.Para crear otro registro dentro del conjunto de filas el registro actual, llame a SetRowsetCursorPosition.Por ejemplo, puede combinar SetRowsetCursorPosition mediante la función miembro de GetFieldValue para recuperar dinámicamente los datos de cualquier registro de conjunto de registros.
Para utilizar SetRowsetCursorPosition, debe haber implementado la obtención masiva de filas especificando la opción de CRecordset::useMultiRowFetch de parámetro de dwOptions en la función miembro de Abrir .
SetRowsetCursorPosition llama a la función API SQLSetPosde ODBC.El parámetro de wLockType especifica el estado del bloqueo de fila después de que SQLSetPos se ha ejecutado.la tabla siguiente describe los valores posibles para wLockTypE.
wLockType |
Descripción |
|---|---|
SQL_LOCK_NO_CHANGE (valor predeterminado) |
El controlador o el origen de datos garantiza que la fila esté en el estado bloqueada o desbloqueada igual que antes de que SetRowsetCursorPosition se denomina. |
SQL_LOCK_EXCLUSIVE |
el controlador o el origen de datos bloquea la fila exclusivamente.No todos los orígenes de datos admiten este tipo de bloqueo. |
SQL_LOCK_UNLOCK |
el controlador o el origen de datos desbloquea la fila.No todos los orígenes de datos admiten este tipo de bloqueo. |
Para obtener más información sobre SQLSetPos, vea Windows SDK.Para obtener más información sobre la obtención masiva de filas, vea el artículo conjunto de registros: Obtener registros de forma masiva (ODBC).
Requisitos
encabezado: afxdb.h