Definindo campos de descritor

Para modificar os campos de um descritor, um aplicativo pode chamar SQLSetDescField. Alguns campos são somente leitura e não podem ser definidos. (Consulte a descrição da função SQLSetDescField .)

Os campos de registro do descritor são definidos com um número de registro (RecNumber) de 1 ou superior, enquanto os campos de cabeçalho do descritor são definidos com um número de registro de 0. Um número de registro 0 também é usado para definir campos de marcador, 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 favoritos estão contidos no cabeçalho do descritor, mas não é esse o caso. Os campos de marcador são distintos dos campos de cabeçalho.

Ao definir campos individualmente, o aplicativo deve seguir a sequência definida em SQLSetDescField. Definir alguns campos faz com que o driver defina outros campos. Isso garante que o descritor esteja sempre pronto para usar depois que o aplicativo tiver especificado um tipo de dados. Quando o aplicativo define o campo SQL_DESC_TYPE, o driver verifica se outros campos que especificam o tipo são válidos e consistentes.

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