Configurazione dei campi del descrittore

Per modificare i campi di un descrittore, un'applicazione può chiamare SQLSetDescField. Alcuni campi sono di sola lettura e non possono essere impostati. (Vedere la descrizione della funzione SQLSetDescField.

I campi dei record descrittori vengono impostati con un numero del record (RecNumber) pari o superiore a 1, mentre i campi di intestazione del descrittore vengono impostati con un numero di record pari a 0. Viene inoltre utilizzato un numero del record pari a 0 per impostare i campi del segnalibro, in conformità alla convenzione secondo la quale i segnalibri sono contenuti nella colonna 0. Ciò potrebbe dare l'impressione che i campi del segnalibro siano contenuti nell'intestazione del descrittore, ma non è così. I campi del segnalibro sono distinti dai campi di intestazione.

Quando vengono impostati i campi singolarmente, l'applicazione deve seguire la sequenza definita in SQLSetDescField. L'impostazione di alcuni campi fa sì che il driver imposti altri campi. In questo modo, il descrittore è sempre pronto per l'uso dopo che l'applicazione ha specificato un tipo di dati. Quando l'applicazione imposta il campo SQL_DESC_TYPE, il driver verifica che gli altri campi che specificano il tipo siano validi e coerenti.

Se una chiamata di funzione che imposta un campo descrittore ha esito negativo, il contenuto del campo descrittore non viene definito dopo la chiamata di funzione non riuscita.