Numero di righe recuperate e stato

Se l'attributo dell'istruzione SQL_ATTR_ROWS_FETCHED_PTR è stato impostato, esso specifica un buffer che restituisce il numero di righe recuperate dalla chiamata a SQLFetch o SQLFetchScroll e le righe di errore. (Questo numero è un conteggio di tutte le righe che non hanno lo stato SQL_ROW_NO_ROWS). Dopo una chiamata a SQLBulkOperations o SQLSetPos, il buffer contiene il numero di righe interessate da un'operazione in blocco eseguita dalla funzione. Se è stato impostato l'attributo dell'istruzione SQL_ATTR_ROW_STATUS_PTR, SQLFetch o SQLFetchScroll restituisce la matrice di stato della riga, che fornisce lo stato di ogni riga restituita. Entrambi i buffer a cui puntano questi campi vengono allocati dall'applicazione e popolati dal driver. Un'applicazione deve garantire che questi puntatori rimangano validi fino alla chiusura del cursore.

Le voci nella matrice di stato della riga indicano se ogni riga è stata recuperata correttamente, se è stata aggiornata, aggiunta o annullata da quando è stata recuperata per l'ultima volta e se si è verificato un errore durante il recupero della riga. Se SQLFetch o SQLFetchScroll rileva un errore durante il recupero di una riga di un set di righe a riga multipla, o se SQLBulkOperations con un argomento Operation di SQL_FETCH_BY_BOOKMARK rileva un errore durante l'esecuzione di un recupero in blocco, esso imposta il valore corrispondente nella matrice di stato della riga su SQL_ROW_ERROR, continua a recuperare righe e restituisce SQL_SUCCESS_WITH_INFO. Per maggiori informazioni sulla gestione degli errori e sulla matrice di stato delle righe, vedere le descrizioni delle funzioni SQLFetch e SQLFetchScroll.