Impostazione 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 di record (RecNumber) pari a 1 o superiore, mentre i campi di intestazione del descrittore vengono impostati con un numero di record pari a 0. Viene inoltre utilizzato un numero di record pari a 0 per impostare i campi del segnalibro, in base alla convenzione che i segnalibri sono contenuti nella colonna 0. Ciò potrebbe lasciare l'impressione che i campi del segnalibro siano contenuti nell'intestazione del descrittore, ma questo non è il caso. I campi segnalibro sono distinti dai campi di intestazione.

Quando si impostano 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.