SQLSetDescRec
Berlaku untuk: 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Topik ini membahas fungsionalitas SQLSetDescRec yang khusus untuk SQL Server Native Client.
Parameter SQLSetDescRec dan Table-Valued
SQLSetDescRec dapat digunakan untuk mengatur bidang deskriptor untuk parameter bernilai tabel dan kolom parameter bernilai tabel. Kolom parameter bernilai tabel hanya tersedia saat bidang header deskriptor SQL_SOPT_SS_PARAM_FOCUS diatur ke ordinal rekaman yang memiliki SQL_DESC_TYPE diatur ke SQL_SS_TABLE. Untuk informasi selengkapnya tentang SQL_SOPT_SS_PARAM_FOCUS, lihat SQLSetStmtAttr.
Tabel berikut ini menjelaskan pemetaan antara parameter dan bidang deskriptor.
| Parameter | Atribut terkait untuk jenis parameter bernilai non-tabel, termasuk kolom parameter bernilai tabel | Atribut terkait untuk parameter bernilai tabel |
|---|---|---|
| Jenis | SQL_DESC_TYPE | SQL_SS_TABLE |
| SubType | Diabaikan | Untuk rekaman tipe SQL_DATETIME atau SQL_INTERVAL, atur ini ke SQL_DESC_DATETIME_INTERVAL_CODE. |
| Panjang | SQL_DESC_OCTET_LENGTH | Panjang nama jenis parameter bernilai tabel. Ini dapat SQL_NTS jika nama jenis dihentikan null, atau nol jika nama jenis parameter bernilai tabel tidak diperlukan. |
| Presisi | SQL_DESC_PRECISION | SQL_DESC_ARRAY_SIZE |
| Sisik | SQL_DESC_SCALE | Tidak digunakan. Parameter ini harus nol. |
| DataPtr | SQL_DESC_DATA_PTR dalam APD | SQL_CA_SS_TYPE_NAME Parameter ini bersifat opsional untuk panggilan prosedur tersimpan, dan NULL dapat ditentukan jika tidak diperlukan. Parameter ini harus ditentukan untuk pernyataan SQL yang bukan panggilan prosedur. DataPtr juga berfungsi sebagai nilai unik yang dapat digunakan aplikasi untuk mengidentifikasi parameter bernilai tabel ini saat pengikatan baris variabel digunakan. |
| StringLengthPtr | SQL_DESC_OCTET_LENGTH_PTR | SQL_DESC_OCTET_LENGTH_PTR Untuk parameter bernilai tabel, ini adalah jumlah baris yang akan ditransfer atau SQL_DATA_AT_EXEC. Ini adalah penunjuk ke nilai yang menyimpan jumlah baris untuk ditransfer dengan SQLExecDirect. |
| IndicatorPtr | SQL_DESC_INDICATOR_PTR | SQL_DESC_INDICATOR_PTR |
Untuk informasi selengkapnya tentang parameter bernilai tabel, lihat Parameter Bernilai Tabel (ODBC).
Dukungan SQLSetDescRec untuk Fitur Tanggal dan Waktu yang Ditingkatkan
Nilai yang diizinkan untuk jenis tanggal/waktu adalah sebagai berikut:
| Atribut | Jenis | SubType | Panjang | Presisi | Sisik |
|---|---|---|---|---|---|
| datetime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| date | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| waktu | SQL_SS_TIME2 | 0 | 10 | 0..7 | 0..7 |
| tanggalwaktu2 | SQL_DATETIME | SQL_CODE_TIMESTAMP | 16 | 0..7 | 0..7 |
| tanggalwaktulewat | SQL_SS_TIMESTAMPOFFSET | 0 | 20 | 0..7 | 0..7 |
Untuk informasi selengkapnya, lihat Peningkatan Tanggal dan Waktu (ODBC).
Dukungan SQLSetDescRec untuk UDT CLR Besar
SQLSetDescRec mendukung jenis yang ditentukan pengguna (UDT) CLR besar. Untuk informasi selengkapnya, lihat Jenis Yang Ditentukan Pengguna (ODBC) CLR Besar.