SQLSetDescField

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

SQLSetDescField kann verwendet werden, um Deskriptorfelder für Tabellenwertparameter und Tabellenwertparameterspalten festzulegen. Informationen zu den verfügbaren Feldern finden Sie unter Tabellenwertparameterdeskriptorfelder und Deskriptorfelder für Table-Valued Parameter-Konstituierende Spalten.

Bemerkungen

Tabellenwertparameter-Spalten sind nur verfügbar, wenn das Deskriptorheaderfeld SQL_SOPT_SS_PARAM_FOCUS auf die Ordnungszahl eines Datensatzes festgelegt ist, für den SQL_DESC_TYPE auf SQL_SS_TABLE eingestellt ist. Weitere Informationen zu SQL_SOPT_SS_PARAM_FOCUS finden Sie unter SQLSetStmtAttr.

Wenn versucht wird, SQL_SOPT_SS_PARAM_FOCUS auf die Ordnungszahl eines Parameters festzulegen, der kein Tabellenwertparameter ist, gibt SQLSetStmtAttr SQL_ERROR zurück, und ein Diagnosedatensatz wird mit SQLSTATE = HY024 und der Meldung "Ungültiger Attributwert" erstellt. SQL_SOPT_SS_PARAM_FOCUS wird nicht geändert, wenn SQL_ERROR zurückgegeben wird.

Durch das Festlegen von SQL_SOPT_SS_PARAM_FOCUS auf 0 (null) wird der Zugriff auf Deskriptordatensätze für Parameter wiederhergestellt.

Weitere Informationen zu Tabellenwertparametern finden Sie unter Tabellenwertparameter (ODBC).

SQLSetDescField-Unterstützung für erweiterte Funktionen zu Datum und Uhrzeit

Datum/Uhrzeit-Funktionen wurden in ODBC verbessert. Informationen über das für die neuen Datum/Uhrzeittypen verfügbare Deskriptorfeld finden Sie unter Parameter and Result Metadata.

Weitere Informationen finden Sie unter Verbesserungen an Datum und Uhrzeit (ODBC).

SQLSetDescField-Unterstützung für große CLR-UDTs

SQLSetDescField unterstützt große benutzerdefinierte CLR-Typen (UDTs). Weitere Informationen finden Sie unter Large CLR User-Defined Types (ODBC).

SQLSetDescField-Unterstützung für Spalten mit geringer Dichte

SQLSetDecField kann verwendet werden, um SQL_SOPT_SS_NAME_SCOPE im Anwendungsparameterdeskriptor (APD) auf die Werte SQL_SS_NAME_SCOPE_EXTENDED und SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET festzulegen.

Weitere Informationen finden Sie unter Unterstützung von Sparsespalten (ODBC).

Weitere Informationen

SQLSetDescField
ODBC API Implementation Details