Partilhar via

SQLGetDescField e SQLGetDescRec (Biblioteca de cursores)

  • Artigo

Importante

Esse recurso será removido em uma versão futura do Windows. Evite usar esse recurso em um novo trabalho de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. A Microsoft recomenda usar a funcionalidade de cursor do driver.

Este tópico discute o uso das funções SQLGetDescField e SQLGetDescRec na biblioteca de cursores. Para obter informações gerais sobre essas funções, consulte Função SQLGetDescField e Função SQLGetDescRec.

A biblioteca de cursores executa SQLGetDescRec para retornar metadados para colunas de indicador. A biblioteca de cursores executa SQLGetDescField para retornar os mesmos campos retornados por SQLGetDescRec, que são SQL_DESC_NAME, SQL_DESC_TYPE, SQL_DESC_DATETIME_INTERVAL_CODE, SQL_DESC_OCTET_LENGTH, SQL_DESC_PRECISION, SQL_DESC_SCALE e SQL_DESC_NULLABLE. Para consistência, SQLGetDescField também retorna SQL_DESC_UNNAMED.

A biblioteca de cursores executa SQLGetDescField quando é chamada para retornar o valor dos seguintes campos definidos para colunas de indicador de associação: SQL_DESC_DATA_PTR, SQL_DESC_INDICATOR_PTR, SQL_DESC_OCTET_LENGTH_PTR e SQL_DESC_LENGTH.

A biblioteca de cursores executa SQLGetDescField quando é chamada para retornar o valor do campo SQL_DESC_BIND_OFFSET_PTR, SQL_DESC_BIND_TYPE, SQL_DESC_ROW_ARRAY_SIZE ou SQL_DESC_ROW_STATUS_PTR. Esses campos podem ser retornados para qualquer linha, não apenas para a linha do indicador.

Se um aplicativo chamar SQLGetDescField para retornar o valor de qualquer campo diferente daqueles mencionados anteriormente, a biblioteca de cursores passará a chamada para o driver.