Radstatusmatris

Förutom data kan SQLFetch och SQLFetchScroll returnera en matris som ger status för varje rad i raduppsättningen. Den här matrisen anges via SQL_ATTR_ROW_STATUS_PTR-instruktionsattributet. Den här matrisen allokeras av programmet och måste ha så många element som anges av SQL_ATTR_ROW_ARRAY_SIZE-instruktionsattributet. Värdena i matrisen anges av SQLBulkOperations, SQLFetch, SQLFetchScroll och SQLSetPos. Värdena beskriver status för raden och om statusen har ändrats sedan den senast hämtades.

Radstatus-arrayvärde	Description
SQL_ROW_SUCCESS	Raden hämtades framgångsrikt och har inte ändrats sedan den hämtades senast.
SQL_ROW_SUCCESS_WITH_INFO	Raden hämtades framgångsrikt och har inte ändrats sedan den senast hämtades. En varning utfärdades dock om raden.
SQL_ROW_ERROR	Ett fel uppstod när raden skulle hämtas.
SQL_ROW_UPDATED	Raden hämtades och har uppdaterats sedan den senast hämtades. Om raden hämtas igen eller uppdateras av SQLSetPos ändras dess status till den nya statusen. Vissa drivrutiner kan inte identifiera ändringar i data och kan därför inte returnera det här värdet. För att avgöra om en drivrutin kan identifiera uppdateringar av nya rader anropar ett program SQLGetInfo med alternativet SQL_ROW_UPDATES.
SQL_ROW_DELETED	Raden har tagits bort sedan den senast hämtades.
SQL_ROW_ADDED	Raden infogades av SQLBulkOperations. Om raden hämtas igen eller uppdateras av SQLSetPos är dess status SQL_ROW_SUCCESS. Det här värdet anges inte av SQLFetch eller SQLFetchScroll.
SQL_ROW_NOROW	Raduppsättningen överlappade slutet av resultatuppsättningen och ingen rad returnerades som motsvarade det här elementet i radstatusmatrisen.