Bagikan melalui


Status Baris Array

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 Description
SQL_ROW_SUCCESS Baris data berhasil diambil dan belum mengalami perubahan sejak terakhir kali diambil.
SQL_ROW_SUCCESS_WITH_INFO Baris data berhasil diambil dan belum berubah sejak terakhir diambil. Namun, peringatan diberikan 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 ini tumpang tindih dengan akhir dari kumpulan hasil, dan tidak ada baris yang dikembalikan sesuai dengan elemen ini dari array status baris.