Desplazamiento y captura filas (ODBC)

Cuando se usa un cursor desplazable, las aplicaciones llaman a SQLFetchScroll para colocar el cursor y capturar filas. SQLFetchScroll admite el desplazamiento relativo (siguiente, anterior y relativa n filas), desplazamiento absoluto (primera, última y fila n) y posicionamiento por marcador. Los argumentos FetchOrientation y FetchOffset de SQLFetchScroll especifican qué conjunto de filas se va a capturar, como se muestra en los diagramas siguientes.

Captura de los conjuntos de filas siguiente, anterior, primero y último

Captura de los conjuntos de filas siguiente, anterior, primero y último

Captura del conjunto de filas absoluto, relativo y marcado

Capturar conjuntos de filas absolutos, relativos y marcados

SQLFetchScroll coloca el cursor en la fila especificada y devuelve las filas del conjunto de filas a partir de esa fila. Si el conjunto de filas especificado se superpone al final del conjunto de resultados, se devuelve un conjunto de filas parcial. Si el conjunto de filas especificado se superpone al inicio del conjunto de resultados, normalmente se devuelve el primer conjunto de filas del conjunto de resultados. Para obtener detalles completos, vea la descripción de la función SQLFetchScroll.

En algunos casos, es posible que la aplicación quiera colocar el cursor sin recuperar ningún dato. Por ejemplo, podría querer probar si existe una fila o simplemente obtener el marcador de la fila sin traer otros datos a través de la red. Para ello, establece el atributo SQL_ATTR_RETRIEVE_DATA instrucción en SQL_RD_OFF. La variable enlazada a la columna bookmark (si existe) siempre se actualiza, independientemente de la configuración de este atributo de instrucción.

Una vez recuperado el conjunto de filas, la aplicación puede llamar a SQLSetPos para colocarlo en una fila determinada del conjunto de filas o actualizar las filas del conjunto de filas. Para obtener más información sobre el uso de SQLSetPos, vea Actualizar datos con SQLSetPos.

Nota

El desplazamiento se admite en ODBC 2. x controladores de SQLExtendedFetch. Para obtener más información, vea Bloquear cursores, cursores desplazablesy Compatibilidad con versiones anteriores en Apéndice G: Directrices del controlador para la compatibilidad con versiones anteriores.