Número de filas recuperadas y estado

Si se ha establecido el atributo de instrucción SQL_ATTR_ROWS_FETCHED_PTR, especifica un búfer que devuelve el número de filas capturadas por la llamada a SQLFetch o SQLFetchScroll y las filas de error. (Este número es un recuento de todas las filas que no tienen el estado SQL_ROW_NO_ROWS). Después de una llamada a SQLBulkOperations o SQLSetPos, el búfer contiene el número de filas afectadas por una operación masiva realizada por la función. Si se ha establecido el atributo de instrucción SQL_ATTR_ROW_STATUS_PTR, SQLFetch o SQLFetchScroll devuelve la matriz de estado de fila, que proporciona el estado de cada fila devuelta. La aplicación asigna los dos búferes a los que apunta la aplicación y el controlador los rellena. Una aplicación debe asegurarse de que estos punteros sigan siendo válidos hasta que se cierre el cursor.

Las entradas de la matriz de estado de fila especifican si cada fila se capturó correctamente, si se actualizó, agregó o eliminó desde que se capturó por última vez y si se produjo un error al capturar la fila. Si SQLFetch o SQLFetchScroll encuentra un error al recuperar una fila de un conjunto de filas con varias filas, o si SQLBulkOperations con un argumento Operation de SQL_FETCH_BY_BOOKMARK encuentra un error al realizar una captura masiva, establece el valor correspondiente de la matriz de estado de fila en SQL_ROW_ERROR, continúa capturando filas y devuelve SQL_SUCCESS_WITH_INFO. Para obtener más información sobre el control de errores y la matriz de estado de fila, consulte las descripciones de las funciones SQLFetch y SQLFetchScroll.