SQLSetDescField

Si applica a: sìSQL Server (tutte le versioni supportate) Sìdatabase SQL di Azure SìIstanza gestita di SQL di Azure sìAzure Synapse Analytics sìParallel Data Warehouse

SQLSetDescField può essere usato per impostare i campi di descrizione per i parametri con valori di tabella e le colonne di parametri con valori di tabella. Per informazioni sui campi disponibili, vedere Table-Valued Parameter Descriptor Fields and Descriptor Fields for Table-Valued Parameter Constituent Columns.

Commenti

Le colonne dei parametri con valori di tabella sono disponibili solo quando il campo di intestazione di descrizione SQL_SOPT_SS_PARAM_FOCUS è impostato sul numero ordinale di un record in cui SQL_DESC_TYPE è impostato su SQL_SS_TABLE. Per ulteriori informazioni su SQL_SOPT_SS_PARAM_FOCUS, vedere SQLSetStmtAttr.

Se si tenta di impostare SQL_SOPT_SS_PARAM_FOCUS sul numero ordinale di un parametro che non è un parametro con valori di tabella, SQLSetStmtAttr restituisce SQL_ERROR e viene creato un record di diagnostica con SQLSTATE = HY024 e il messaggio "Valore attributo non valido". SQL_SOPT_SS_PARAM_FOCUS non viene modificato al momento della restituzione di SQL_ERROR.

L'impostazione di SQL_SOPT_SS_PARAM_FOCUS su 0 ripristina l'accesso ai record del descrittore per i parametri.

Per altre informazioni sui parametri con valori di tabella, vedere Parametri con valori di tabella (ODBC).

Supporto di SQLSetDescField per le caratteristiche avanzate di data e ora

Le caratteristiche di data/ora sono state migliorate in ODBC. Per informazioni sul campo di descrizione fornito per i nuovi tipi di data/ora, vedere Parameter and Result Metadata.

Per altre informazioni, vedere Miglioramenti di data e ora (ODBC).

Supporto di SQLSetDescField per tipi CLR definiti dall'utente di grandi dimensioni

SQLSetDescField supporta tipi CLR definiti dall'utente (UDT) di grandi dimensioni. Per altre informazioni, vedere Tipi CLR User-Defined di grandi dimensioni (ODBC).

Supporto di SQLSetDescField per colonne di tipo sparse

SQLSetDecField può essere usato per SQL_SOPT_SS_NAME_SCOPE nel descrittore del parametro dell'applicazione (APD) ai valori SQL_SS_NAME_SCOPE_EXTENDED e SQL_SS_NAME_SCOPE_SPARSE_COLUMN_SET.

Per altre informazioni, vedere Supporto delle colonne di tipo sparse (ODBC).

Vedere anche

SQLSetDescField
Dettagli di implementazione dell'API ODBC