Definindo campos descritores

Para modificar os campos de um descriptor, uma aplicação pode chamar SQLSetDescField. Alguns campos são apenas de leitura e não podem ser definidos. (Ver a descrição da função SQLSetDescField .)

Os campos de registo descritor são definidos com um número de registo (RecNumber) de 1 ou superior, enquanto os campos de cabeçalho de descritor têm um número de registo de 0. Um número recorde de 0 também é usado para definir campos de favoritos, de acordo com a convenção de que os favoritos estão contidos na coluna 0. Isto pode dar a impressão de que os campos de favoritos estão contidos no cabeçalho do descritor, mas não é o caso. Os campos de marcadores são distintos dos campos de cabeçalho.

Ao definir campos individualmente, a aplicação deve seguir a sequência definida no SQLSetDescField. Definir alguns campos faz com que o driver defina outros campos. Isto garante que o descritor está sempre pronto a ser usado assim que a aplicação especifica um tipo de dado. Quando a aplicação 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 fica indefinido após a falha na chamada de função.