Delen via

Rijstatusmatrix

Naast gegevens kunnen SQLFetch en SQLFetchScroll een matrix retourneren die de status van elke rij in de rijenset geeft. Deze array wordt opgegeven via de instructie-attribuut SQL_ATTR_ROW_STATUS_PTR. Deze matrix wordt toegewezen door de toepassing en moet zoveel elementen bevatten als die zijn opgegeven door het kenmerk SQL_ATTR_ROW_ARRAY_SIZE instructie. De waarden in de matrix worden ingesteld door SQLBulkOperations, SQLFetch, SQLFetchScroll en SQLSetPos. De waarden beschrijven de status van de rij en of die status is gewijzigd sinds het laatst is opgehaald.

Matrixwaarde rijstatus Description
SQL_ROW_SUCCESS De rij is succesvol opgehaald en is niet gewijzigd sinds het voor het laatst is opgehaald.
SQL_ROW_SUCCESS_WITH_INFO De rij is succesvol opgehaald en is niet gewijzigd sinds de laatste keer dat deze werd opgehaald. Er is echter een waarschuwing teruggegeven voor de rij.
SQL_ROW_ERROR Er is een fout opgetreden tijdens het ophalen van de rij.
SQL_ROW_UPDATED De rij is succesvol opgehaald en is bijgewerkt nadat deze voor het laatst is opgehaald. Als de rij opnieuw wordt opgehaald of vernieuwd door SQLSetPos, wordt de status ervan gewijzigd in de nieuwe status.

Sommige stuurprogramma's kunnen geen wijzigingen in gegevens detecteren en kunnen daarom deze waarde niet retourneren. Een toepassing roept SQLGetInfo aan met de optie SQL_ROW_UPDATES om te bepalen of een driver updates voor opnieuw opgehaalde rijen kan detecteren.
SQL_ROW_DELETED De rij is verwijderd sinds deze voor het laatst is opgehaald.
SQL_ROW_ADDED De rij is ingevoegd door SQLBulkOperations. Als de rij opnieuw wordt opgehaald of wordt vernieuwd door SQLSetPos, wordt de status SQL_ROW_SUCCESS.

Deze waarde is niet ingesteld door SQLFetch of SQLFetchScroll.
SQL_ROW_NOROW De rijenset overlapte het einde van de resultatenset en er is geen rij geretourneerd die overeenkomt met dit element van de rijstatusmatrix.
  • Last updated on