Jumlah Baris yang Diambil dan Status

Jika atribut pernyataan SQL_ATTR_ROWS_FETCHED_PTR telah ditetapkan, atribut tersebut menentukan buffer yang mengembalikan jumlah baris yang diambil oleh panggilan ke SQLFetch atau SQLFetchScroll, dan baris kesalahan. (Angka ini adalah hitungan dari semua baris yang tidak memiliki status SQL_ROW_NO_ROWS.) Setelah panggilan ke SQLBulkOperations atau SQLSetPos, buffer berisi jumlah baris yang terpengaruh oleh operasi massal yang dilakukan oleh fungsi. Jika atribut pernyataan SQL_ATTR_ROW_STATUS_PTR telah ditetapkan, SQLFetch atau SQLFetchScroll mengembalikan array status baris, yang menyediakan status setiap baris yang dikembalikan. Kedua buffer yang dialokasikan oleh bidang ini dialokasikan oleh aplikasi dan diisi oleh driver. Aplikasi harus memastikan bahwa pointer ini tetap valid hingga kursor ditutup.

Entri dalam status array status baris apakah setiap baris berhasil diambil, baik diperbarui, ditambahkan, atau dihapus sejak terakhir diambil, dan apakah terjadi kesalahan saat mengambil baris. Jika SQLFetch atau SQLFetchScroll mengalami kesalahan saat mengambil satu baris set baris multirow, atau jika SQLBulkOperations dengan argumen Operasi SQL_FETCH_BY_BOOKMARK mengalami kesalahan saat melakukan pengambilan massal, SQLBulkOperations mengatur nilai yang sesuai dalam array status baris ke SQL_ROW_ERROR, melanjutkan mengambil baris, dan mengembalikan SQL_SUCCESS_WITH_INFO. Untuk informasi selengkapnya tentang penanganan kesalahan dan array status baris, lihat deskripsi fungsi SQLFetch dan SQLFetchScroll .