Matriz de Estados de fila

Además de los datos, SQLFetch y SQLFetchScroll pueden devolver una matriz que proporcione el estado de cada fila del conjunto de filas. Esta matriz se especifica a través del atributo de instrucción SQL_ATTR_ROW_STATUS_PTR. La aplicación asigna esta matriz y debe tener tantos elementos como se especifican en el atributo de instrucción SQL_ATTR_ROW_ARRAY_SIZE. Los valores de la matriz se establecen mediante SQLBulkOperations, SQLFetch, SQLFetchScroll y SQLSetPos. Los valores describen el estado de la fila y si ese estado ha cambiado desde que se capturó por última vez.

Valor de matriz de estado de fila	Descripción
SQL_ROW_SUCCESS	La fila se ha recuperado correctamente y no ha cambiado desde la última vez que se recuperó.
SQL_ROW_SUCCESS_WITH_INFO	La fila se ha recuperado correctamente y no ha cambiado desde la última vez que se recuperó. Sin embargo, se devolvió una advertencia sobre la fila.
SQL_ROW_ERROR	Se ha producido un error al recuperar la fila.
SQL_ROW_UPDATED	La fila se ha recuperado correctamente y se ha actualizado desde la última vez que se recuperó. Si SQLSetPos vuelve a recuperar o actualiza la fila, su estado se cambia al nuevo estado. Algunos controladores no pueden detectar cambios en los datos y, por tanto, no pueden devolver este valor. Para determinar si un controlador puede detectar actualizaciones para las filas capturadas, una aplicación llama a SQLGetInfo con la opción SQL_ROW_UPDATES.
SQL_ROW_DELETED	La fila se ha eliminado desde la última vez que se recuperó.
SQL_ROW_ADDED	SQLBulkOperations insertó la fila. Si SQLSetPos vuelve a recuperar o actualiza la fila, su estado es SQL_ROW_SUCCESS. Este valor no es establecido por SQLFetch ni SQLFetchScroll.
SQL_ROW_NOROW	El conjunto de filas se superpone al final del conjunto de resultados y no se devolvió ninguna fila correspondiente a este elemento de la matriz de estado de fila.