SQLGetStmtAttr

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

Driver ODBC SQL Server Native Client memperluas SQLGetStmtAttr untuk mengekspos atribut pernyataan khusus driver.

SQLSetStmtAttr mencantumkan atribut pernyataan yang dibaca dan ditulis. Topik ini mencantumkan atribut pernyataan baca-saja.

SQL_SOPT_SS_CURRENT_COMMAND

Atribut SQL_SOPT_SS_CURRENT_COMMAND mengekspos perintah batch perintah saat ini. Pengembalian adalah bilangan bulat yang menentukan lokasi perintah dalam batch. Nilai ValuePtr berjenis SQLLEN.

SQL_SOPT_SS_NOCOUNT_STATUS

Atribut SQL_SOPT_SS_NOCOUNT_STATUS menunjukkan pengaturan opsi NOCOUNT saat ini, yang mengontrol apakah SQL Server melaporkan jumlah baris yang terpengaruh oleh pernyataan ketika SQLRowCount dipanggil. Nilai ValuePtr berjenis SQLLEN.

Nilai Deskripsi
SQL_NC_OFF NOCOUNT NONAKTIF. SQLRowCount mengembalikan jumlah baris yang terpengaruh.
SQL_NC_ON NOCOUNT aktif. Jumlah baris yang terpengaruh tidak dikembalikan oleh SQLRowCount dan nilai yang dikembalikan adalah 0.

Jika SQLRowCount mengembalikan 0, aplikasi harus menguji SQL_SOPT_SS_NOCOUNT_STATUS. Jika SQL_NC_ON dikembalikan, nilai 0 dari SQLRowCount hanya menunjukkan bahwa SQL Server belum mengembalikan jumlah baris. Jika SQL_NC_OFF dikembalikan, itu berarti NOCOUNT nonaktif dan nilai 0 dari SQLRowCount menunjukkan bahwa pernyataan tidak memengaruhi baris apa pun.

Aplikasi tidak boleh menampilkan nilai SQLRowCount saat SQL_SOPT_SS_NOCOUNT_STATUS SQL_NC_OFF. Batch besar atau prosedur tersimpan dapat berisi beberapa pernyataan SET NOCOUNT, sehingga tidak dapat diasumsikan bahwa SQL_SOPT_SS_NOCOUNT_STATUS tetap konstan. Opsi ini harus diuji setiap kali SQLRowCount mengembalikan 0.

SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT

Atribut SQL_SOPT_SS_QUERYNOTIFICATION_MSGTEXT mengembalikan teks pesan untuk permintaan pemberitahuan kueri.

Parameter Bernilai Tabel dan SQLGetStmtAttr

SQLGetStmtAttr dapat dipanggil untuk mendapatkan nilai SQL_SOPT_SS_PARAM_FOCUS dalam deskriptor parameter aplikasi (APD) saat bekerja dengan parameter bernilai tabel. Untuk informasi selengkapnya tentang SQL_SOPT_SS_PARAM_FOCUS, lihat SQLSetStmtAttr.

Untuk informasi selengkapnya tentang parameter bernilai tabel, lihat Parameter Bernilai Tabel (ODBC).

Lihat Juga

Fungsi SQLSetStmtAttr
Detail Implementasi ODBC API