SQLGetDescRec
Topik ini membahas fungsionalitas SQLGetDescRec yang khusus untuk SQL Server Native Client.
Parameter SQLGetDescRec dan Table-Valued
SQLGetDescRec dapat digunakan untuk mendapatkan nilai untuk atribut parameter bernilai tabel dan kolom parameter bernilai tabel. Parameter RecNumber SQLGetDescRec sesuai dengan parameter ParameterNumber SQLBindParameter.
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 tentang, lihat SQLSetStmtAttr.
SQLGetDescRec mengembalikan data berikut:
| Parameter | Parameter bernilai tabel | Kolom parameter bernilai tabel dan parameter lainnya |
|---|---|---|
| Nama | Nama parameter formal untuk panggilan prosedur tersimpan; jika tidak, string panjang 0. | Nama kolom parameter bernilai tabel. |
| TypePtr | SQL_DESC_TYPE. Untuk parameter yang dibersihkan tabel, ini SQL_SS_TABLE. | SQL_DESC_TYPE |
| SubTypePtr | Tidak ditentukan | SQL_DESC_DATETIME_INTERVAL_CODE (Untuk catatan jenis SQL_DATETIME atau SQL_INTERVAL.) |
| LengthPtr | 0 | SQL_DESC_OCTET_LENGTH |
| PresisiPtr | 0 | SQL_DESC_PRECISION |
| ScalePtr | 0 | SQL_DESC_SCALE |
| NullablePtr | 1 | SQL_DESC_NULLABLE |
Untuk informasi selengkapnya tentang parameter bernilai tabel, lihat Parameter Bernilai Tabel (ODBC).
Dukungan SQLGetDescRec untuk Fitur Tanggal dan Waktu yang Ditingkatkan
Nilai yang dikembalikan untuk jenis tanggal/waktu adalah sebagai berikut:
| TypePtr | SubTypePtr | LengthPtr | PresisiPtr | ScalePtr | |
|---|---|---|---|---|---|
| tanggalwaktu | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| tanggal | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| waktu | SQL_SS_TIME2 | 0 | 10 | 0..7 | 0..7 |
| datetime2 | 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 SQLGetDescRec untuk UDT CLR Besar
SQLGetDescRec mendukung jenis yang ditentukan pengguna (UDT) CLR yang besar. Untuk informasi selengkapnya, lihat Jenis User-Defined CLR Besar (ODBC).