Popolamento automatico dell'IPD

Alcuni driver sono in grado di impostare i campi del DP dopo la preparazione di una query con parametri. I campi descrittore vengono popolati automaticamente con informazioni sul parametro, tra cui il tipo di dati, la precisione, la dimensione e altre caratteristiche. Equivale al supporto SQLDescribeParam. Queste informazioni possono essere particolarmente utili per un'applicazione quando non ha altro modo di individuarlo, ad esempio quando viene eseguita una query ad hoc con parametri che l'applicazione non conosce.

Un'applicazione determina se il driver supporta il popolamento automatico chiamando SQLGetConnectAttr con un attributo di SQL_ATTR_AUTO_IPD. Se viene restituito SQL_TRUE, il driver lo supporta e l'applicazione può abilitarlo impostando l'attributo dell'istruzione SQL_ATTR_ENABLE_AUTO_IPD su SQL_TRUE.

Quando il popolamento automatico è supportato e abilitato, il driver popola i campi del DP dopo che un'istruzione SQL contenente marcatori di parametro è stata preparata da una chiamata a SQLPrepare. Un'applicazione può recuperare queste informazioni chiamando SQLGetDescField, SQLGetDescRec o SQLDescribeParam. L'applicazione può usare le informazioni per associare il buffer dell'applicazione più appropriato a un parametro o per specificare una conversione dei dati.

Il popolamento automatico del DP potrebbe comportare una riduzione delle prestazioni. Un'applicazione può disattivarlo reimpostando l'attributo dell'istruzione SQL_ATTR_ENABLE_AUTO_IPD su SQL_FALSE (valore predefinito).