SQLRowCount

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Ketika array nilai parameter terikat untuk eksekusi pernyataan, SQLRowCount mengembalikan SQL_ERROR jika ada baris nilai parameter yang menghasilkan kondisi kesalahan dalam eksekusi pernyataan. Tidak ada nilai yang dikembalikan melalui argumen RowCountPtr fungsi.

Aplikasi dapat memanfaatkan atribut pernyataan SQL_ATTR_PARAMS_PROCESSED_PTR untuk mengambil jumlah parameter yang diproses sebelum kesalahan terjadi.

Selanjutnya, aplikasi dapat menggunakan array nilai status, terikat dengan menggunakan atribut pernyataan SQL_ATTR_PARAM_STATUS_PTR, untuk menangkap offset array dari baris parameter yang menyinggung. Aplikasi dapat melintasi array status untuk menentukan jumlah baris aktual yang diproses.

Ketika pernyataan TRANSACT-SQL INSERT, UPDATE, DELETE, atau MERGE dengan klausul OUTPUT dijalankan, SQLRowCount tidak akan mengembalikan jumlah baris yang terpengaruh sampai semua baris dalam tataan hasil yang dihasilkan oleh klausa OUTPUT telah digunakan. Untuk menggunakan baris ini, Anda memanggil SQLFetch atau SQLFetchScroll. SQLResultCols akan mengembalikan -1 hingga semua baris hasil telah digunakan. Setelah SQLFetch atau SQLFetchScroll mengembalikan SQL_NO_DATA, aplikasi harus memanggil SQLRowCount untuk menentukan jumlah baris yang terpengaruh sebelum memanggil SQLMoreResults untuk berpindah ke hasil berikutnya.

Lihat Juga

Fungsi SQLRowCount
Detail Implementasi ODBC API