Bagikan melalui


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.