Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo argomento illustra la funzionalità SQLSetDescRec specifica di SQL Server Native Client.
Parametri SQLSetDescRec e Table-Valued
SQLSetDescRec può essere usato per impostare i campi del descrittore per i parametri con valori di tabella e le colonne dei parametri con valori di tabella. 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 altre informazioni sulle SQL_SOPT_SS_PARAM_FOCUS, vedere SQLSetStmtAttr.
Nella tabella seguente viene descritto il mapping tra i parametri e i campi del descrittore.
| Parametro | Attributo correlato per i tipi di parametri non con valori di tabella, incluse le colonne dei parametri con valori di tabella | Attributo correlato per i parametri con valori di tabella |
|---|---|---|
| Tipo | SQL_DESC_TYPE | SQL_SS_TABLE |
| Sottotipo | Ignorato | Per i record di tipo SQL_DATETIME o SQL_INTERVAL, impostarlo su SQL_DESC_DATETIME_INTERVAL_CODE. |
| Lunghezza | SQL_DESC_OCTET_LENGTH | Lunghezza del nome del tipo di parametro con valori di tabella. Può essere SQL_NTS se il nome del tipo è null terminato oppure zero se il nome del tipo di parametro con valori di tabella non è obbligatorio. |
| precisione | SQL_DESC_PRECISION | SQL_DESC_ARRAY_SIZE |
| Scala | SQL_DESC_SCALE | Inutilizzato. Questo parametro deve essere zero. |
| DataPtr | SQL_DESC_DATA_PTR in APD | SQL_CA_SS_TYPE_NAME Questo parametro è facoltativo per le chiamate di stored procedure e può essere specificato NULL se non è necessario. Questo parametro deve essere specificato per le istruzioni SQL che non sono chiamate di routine. DataPtr funge anche da valore univoco che l'applicazione può usare per identificare questo parametro con valori di tabella quando viene usata l'associazione di righe variabile. |
| stringLengthPtr | SQL_DESC_OCTET_LENGTH_PTR | SQL_DESC_OCTET_LENGTH_PTR Per un parametro con valori di tabella, si tratta del numero di righe da trasferire o SQL_DATA_AT_EXEC. Si tratta di un puntatore a un valore che contiene il numero di righe da trasferire con SQLExecDirect. |
| indicatorPtr | SQL_DESC_INDICATOR_PTR | SQL_DESC_INDICATOR_PTR |
Per altre informazioni sui parametri con valori di tabella, vedere Parametri con valori di tabella (ODBC).
Supporto di SQLSetDescRec per le funzionalità avanzate di data e ora
I valori consentiti per i tipi di data/ora sono i seguenti:
| Tipo | Sottotipo | Lunghezza | precisione | Scala | |
|---|---|---|---|---|---|
| data e ora | SQL_DATETIME | SQL_CODE_TIMESTAMP | 4 | 3 | 3 |
| smalldatetime | SQL_SQL_DATETIME | SQL_CODE_TIMESTAMP | 8 | 0 | 0 |
| dattero | SQL_DATETIME | SQL_CODE_DATE | 6 | 0 | 0 |
| tempo | 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 |
Per altre informazioni, vedere Miglioramenti di data e ora (ODBC).
Supporto di SQLSetDescRec per tipi definiti dall'utente CLR di grandi dimensioni
SQLSetDescRec supporta tipi CLR definiti dall'utente di grandi dimensioni. Per altre informazioni, vedere Tipi CLR definiti dall'utente (ODBC) di grandi dimensioni.