SQLNumResultCols

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

Untuk pernyataan yang dijalankan, driver ODBC SQL Server Native Client tidak mengunjungi server untuk melaporkan jumlah kolom dalam tataan hasil. Dalam hal ini, SQLNumResultCols tidak menyebabkan pulang pergi server. Seperti SQLDescribeCol dan SQLColAttribute, memanggil SQLNumResultCols pada pernyataan yang disiapkan tetapi tidak dijalankan menghasilkan roundtrip server.

Saat pernyataan transact-SQL atau batch pernyataan mengembalikan beberapa kumpulan baris hasil, dimungkinkan bagi jumlah kolom kumpulan hasil untuk diubah dari satu set ke yang lain. SQLNumResultCols harus dipanggil untuk setiap set. Ketika jumlah kolom berubah, aplikasi harus mengikat kembali nilai data sebelum mengambil hasil baris. Untuk informasi selengkapnya tentang menangani beberapa pengembalian kumpulan hasil, lihat SQLMoreResults.

Peningkatan di mesin database yang dimulai dengan SQL Server 2012 (11.x) memungkinkan SQLNumResultCols untuk mendapatkan deskripsi yang lebih akurat dari hasil yang diharapkan. Hasil yang lebih akurat ini mungkin berbeda dari nilai yang dikembalikan oleh SQLNumResultCols di versi SQL Server sebelumnya. Untuk informasi selengkapnya, lihat Penemuan Metadata.

Lihat Juga

Fungsi SQLNumResultCols
Detail Implementasi ODBC API