SQLSetDescRec

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnalytics Platform System (PDW)

Bu konu, SQL Server Native Client'a özgü SQLSetDescRec işlevselliğini tartışmaktadır.

SQLSetDescRec ve Table-Valued Parametreleri

SQLSetDescRec, tablo değerli parametreler ve tablo değerli parametre sütunları için tanımlayıcı alanları ayarlamak için kullanılabilir. Tablo değerli parametre sütunları, yalnızca tanımlayıcı başlık alanı SQL_SOPT_SS_PARAM_FOCUS SQL_DESC_TYPE SQL_SS_TABLE olarak ayarlanmış bir kaydın ordinaline ayarlandığında kullanılabilir. SQL_SOPT_SS_PARAM_FOCUS hakkında daha fazla bilgi için SQLSetStmtAttr adresine bakınız.

Aşağıdaki tablo, parametreler ile tanımlayıcı alanları arasındaki eşlemeyi açıklar.

Parametre Tablo değerli parametre sütunları dahil olmak üzere tablo değerli olmayan parametre türleri için ilgili öznitelik Tablo değerli parametreler için ilgili öznitelik
Tür SQL_DESC_TYPE SQL_SS_TABLE
Alt Ignored SQL_DATETIME veya SQL_INTERVAL tipi kayıtlar için bunu SQL_DESC_DATETIME_INTERVAL_CODE olarak ayarlayın.
Uzunluğu SQL_DESC_OCTET_LENGTH Tablo değerli parametre tipi adının uzunluğu. Bu, tip adı null sonlandırılmışsa SQL_NTS veya tablo değerli parametre tipi adı gerekmiyorsa sıfır olabilir.
Kesinlik SQL_DESC_PRECISION SQL_DESC_ARRAY_SIZE
Scale SQL_DESC_SCALE Unused. Bu parametre sıfır olmalı.
DataPtr SQL_DESC_DATA_PTR APD'de SQL_CA_SS_TYPE_NAME

Bu parametre, saklanan prosedür çağrıları için isteğe bağlıdır ve NULL zorunlu değilse belirtilebilir. Bu parametre, prosedür çağrısı olmayan SQL ifadeleri için belirtilmelidir.

DataPtr ayrıca, değişken satır bağlaması kullanıldığında uygulamanın bu tablo değerli parametreyi tanımlamak için kullanabileceği benzersiz bir değer olarak hizmet eder.
StringLengthPtr SQL_DESC_OCTET_LENGTH_PTR SQL_DESC_OCTET_LENGTH_PTR

Tablo değerli bir parametre için, bu, aktarılacak veya SQL_DATA_AT_EXEC satır sayısıdır. Bu, SQLExecDirect ile aktarılacak satır sayısını tutan bir değere işarettir.
IndicatorPtr SQL_DESC_INDICATOR_PTR SQL_DESC_INDICATOR_PTR

Tablo değerli parametreler hakkında daha fazla bilgi için bkz. Table-Valued Parametreler (ODBC).

SQLSetDescRec Geliştirilmiş Tarih ve Saat Özellikleri için Destek

Tarih/saat türleri için izin verilen değerler şunlardır:

Özellik Tür Alt Uzunluğu Kesinlik Scale
tarih/zaman 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
time SQL_SS_TIME2 0 10 0..7 0..7
datetime2 SQL_DATETIME SQL_CODE_TIMESTAMP 16 0..7 0..7
datetimeoffset SQL_SS_TIMESTAMPOFFSET 0 20 0..7 0..7

Daha fazla bilgi için bkz. Tarih ve Saat Geliştirmeleri (ODBC).

SQLSetDescRec Destek Büyük CLR UDT'ler için

SQLSetDescRec , büyük CLR kullanıcı tanımlı türleri (UDT'ler) destekler. Daha fazla bilgi için bkz. Büyük CLR User-Defined Türleri (ODBC).