Configurazione dei valori dei parametri
Per impostare il valore di un parametro, l'applicazione imposta semplicemente il valore della variabile associata al parametro. Non è importante quando il valore viene impostato, purché sia impostato prima dell'esecuzione dell'istruzione. L'applicazione può impostare il valore prima o dopo l'associazione della variabile e può modificare il valore tutte le volte che vuole. Quando l'istruzione viene eseguita, il driver recupera semplicemente il valore corrente della variabile. Ciò è particolarmente utile quando un'istruzione preparata viene eseguita più volte; l'applicazione imposta nuovi valori per alcune o tutte le variabili ogni volta che viene eseguita l'istruzione. Per un esempio, vedere Esecuzione preparata, illustrata in una parte precedente di questa sezione.
Se nella chiamata a SQLBindParameter è stato associato un buffer di lunghezza/indicatore, questo deve essere impostato su uno dei valori seguenti prima dell'esecuzione dell'istruzione:
Lunghezza dei byte dei dati nella variabile associata. Il driver controlla questa lunghezza solo se la variabile è di tipo carattere o binario (ValueType è SQL_C_CHAR o SQL_C_BINARY).
SQL_NTS. I dati sono una stringa con terminazione Null.
SQL_NULL_DATA. Il valore dei dati è NULL e il driver ignora il valore della variabile associata.
SQL_DATA_AT_EXEC o il risultato della macro SQL_LEN_DATA_AT_EXEC. Il valore del parametro deve essere inviato con SQLPutData. Per altre informazioni, vedere Inviare dati Long, più avanti in questa sezione.
La tabella seguente illustra i valori della variabile associata e il buffer di lunghezza/indicatore impostati dall'applicazione per un'ampia gamma di valori di parametro.
| Parametro value |
Parametro (SQL) tipo di dati |
Variabile (C) tipo di dati |
Valore in Associato Variabile |
Valore in lunghezza/indicatore buffer[d] |
|---|---|---|---|---|
| "ABC" | SQL_CHAR | SQL_C_CHAR | ABC\0[a] | SQL_NTS o 3 |
| 10 | SQL_INTEGER | SQL_C_SLONG | 10 | -- |
| 10 | SQL_INTEGER | SQL_C_CHAR | 10\0[a] | SQL_NTS o 2 |
| 1 P.M. | SQL_TYPE_TIME | SQL_C_TYPE_TIME | 13,0,0[b] | -- |
| 1 P.M. | SQL_TYPE_TIME | SQL_C_CHAR | {t '13:00:00'}\0[a], [c] | SQL_NTS o 14 |
| NULL | SQL_SMALLINT | SQL_C_SSHORT | -- | SQL_NULL_DATA |
[a] "\0" rappresenta un carattere di terminazione Null. Il carattere di terminazione Null è necessario solo se il valore nel buffer di lunghezza/indicatore è SQL_NTS.
[b] I numeri in questo elenco sono i numeri archiviati nei campi della struttura TIME_STRUCT.
[c] La stringa usa la clausola ODBC date escape. Per ulteriori informazioni, vedere Valori letterali data, ora e data e ora.
[d] I driver devono sempre controllare questo valore per verificare se si tratta di un valore speciale, ad esempio SQL_NULL_DATA.
Le operazioni eseguite da un driver con un valore di parametro in fase di esecuzione dipendono dal driver. Se necessario, il driver converte il valore dal tipo di dati C e dalla lunghezza in byte della variabile associata al tipo di dati SQL, alla precisione e alla scala del parametro. Nella maggior parte dei casi, il driver invia quindi il valore all'origine dati. In alcuni casi, formatta il valore come testo e lo inserisce nell'istruzione SQL prima di inviare l'istruzione all'origine dati.