Configurar campos de descritor

Para modificar os campos de um descritor, um aplicativo pode chamar SQLSetDescField. Alguns campos são somente leitura e não é possível defini-los. (Confira a descrição da função SQLSetDescField.)

Os campos de registro do descritor são definidos com um número de registro (RecNumber) igual a 1 ou mais, enquanto os campos de cabeçalho do descritor são definidos com um número de registro igual a 0. Um número de registro igual a 0 também é usado para definir campos de marcadores, de acordo com a convenção de que os marcadores estão contidos na coluna 0. Isso pode dar a impressão de que os campos de indicador estão contidos no cabeçalho do descritor, mas esse não é o caso. Os campos de indicador são diferentes dos campos de cabeçalho.

Ao definir campos individualmente, o aplicativo deve seguir a sequência estabelecida em SQLSetDescField. A configuração de alguns campos faz o driver definir outros campos. Isso assegura que o descritor esteja sempre pronto para uso depois que o aplicativo tiver especificado um tipo de dados. Quando o aplicativo define o campo SQL_DESC_TYPE, o driver verifica se os outros campos que especificam o tipo são válidos e consistentes.

Se uma chamada de função que definiria um campo descritor falhar, o conteúdo do campo descritor será indefinido depois da chamada de função com falha.