Compartir a través de


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 Description
SQL_ROW_SUCCESS La fila se capturó correctamente y no ha cambiado desde que se capturó por última vez.
SQL_ROW_SUCCESS_WITH_INFO La fila se capturó correctamente y no ha cambiado desde que se capturó por última vez. Sin embargo, se devolvió una advertencia sobre la fila.
SQL_ROW_ERROR Se produjo un error al obtener la fila.
SQL_ROW_UPDATED La fila se obtuvo correctamente y se ha actualizado desde la última vez que se obtuvo. Si SQLSetPos vuelve a capturar 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 reconocer actualizaciones en las filas recuperadas nuevamente, una aplicación llama a SQLGetInfo con la opción SQL_ROW_UPDATES.
SQL_ROW_DELETED La fila se ha eliminado desde que se recuperó por última vez.
Fila_SQL_Añadida SQLBulkOperations insertó la fila. Si SQLSetPos vuelve a capturar o actualiza la fila, su estado es SQL_ROW_SUCCESS.

SQLFetch o SQLFetchScroll no establece este valor.
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.