População automática do IPD

Alguns drivers são capazes de definir os campos do IPD após uma consulta parametrizada ter sido preparada. Os campos do descritor são automaticamente preenchidos com informação sobre o parâmetro, incluindo o tipo de dados, precisão, escala e outras características. Isto equivale a suportar SQLDescribeParam. Esta informação pode ser particularmente valiosa para uma aplicação quando esta não tem outra forma de a descobrir, como quando uma consulta ad hoc é realizada com parâmetros que a aplicação desconhece.

Uma aplicação determina se o driver suporta população automática chamando SQLGetConnectAttr com um Atributo de SQL_ATTR_AUTO_IPD. Se SQL_TRUE for devolvido, o driver suporta-o e a aplicação pode habilitá-lo definindo o atributo da instrução SQL_ATTR_ENABLE_AUTO_IPD como SQL_TRUE.

Quando a população automática é suportada e ativada, o driver preenche os campos do IPD depois de uma instrução SQL contendo marcadores de parâmetros ter sido preparada por uma chamada ao SQLPrepare. Uma aplicação pode obter esta informação chamando SQLGetDescField ou SQLGetDescRec, ou SQLDescribeParam. A aplicação pode usar a informação para associar o buffer de aplicação mais apropriado para um parâmetro ou para especificar uma conversão de dados para ele.

A população automática do IPD pode causar uma penalização de desempenho. Uma aplicação pode desligá-lo ao redefinir o atributo da instrução SQL_ATTR_ENABLE_AUTO_IPD para SQL_FALSE (o valor predefinido).