Array Status Baris
Selain data, SQLFetch dan SQLFetchScroll dapat mengembalikan array yang memberikan status setiap baris dalam set baris. Array ini ditentukan melalui atribut pernyataan SQL_ATTR_ROW_STATUS_PTR. Array ini dialokasikan oleh aplikasi dan harus memiliki elemen sebanyak yang ditentukan oleh atribut pernyataan SQL_ATTR_ROW_ARRAY_SIZE. Nilai dalam array diatur oleh SQLBulkOperations, SQLFetch, SQLFetchScroll, dan SQLSetPos. Nilai menjelaskan status baris dan apakah status tersebut telah berubah sejak terakhir diambil.
Nilai array status baris | Deskripsi |
---|---|
SQL_ROW_SUCCESS | Baris berhasil diambil dan belum berubah sejak terakhir diambil. |
SQL_ROW_SUCCESS_WITH_INFO | Baris berhasil diambil dan belum berubah sejak terakhir diambil. Namun, peringatan dikembalikan tentang baris tersebut. |
SQL_ROW_ERROR | Terjadi kesalahan saat mengambil baris. |
SQL_ROW_UPDATED | Baris berhasil diambil dan telah diperbarui sejak terakhir diambil. Jika baris diambil lagi atau di-refresh oleh SQLSetPos, statusnya diubah ke status baru. Beberapa driver tidak dapat mendeteksi perubahan pada data dan karenanya tidak dapat mengembalikan nilai ini. Untuk menentukan apakah driver dapat mendeteksi pembaruan untuk baris yang diambil ulang, aplikasi memanggil SQLGetInfo dengan opsi SQL_ROW_UPDATES. |
SQL_ROW_DELETED | Baris telah dihapus sejak terakhir kali diambil. |
SQL_ROW_ADDED | Baris disisipkan oleh SQLBulkOperations. Jika baris diambil lagi atau di-refresh oleh SQLSetPos, statusnya adalah SQL_ROW_SUCCESS. Nilai ini tidak diatur oleh SQLFetch atau SQLFetchScroll. |
SQL_ROW_NOROW | Set baris tumpang tindih pada akhir kumpulan hasil, dan tidak ada baris yang dikembalikan yang sesuai dengan elemen array status baris ini. |