Compartilhar via


SQLNumResultCols

Para instruções executadas, o driver ODBC do SQL Server Native Client não visita o servidor para informar o número de colunas em um conjunto de resultados. Nesse caso, SQLNumResultCols não provoca uma viagem de ida e volta ao servidor. Como SQLDescribeCol e SQLColAttribute, chamar SQLNumResultCols em instruções preparadas mas não executadas gera uma viagem de ida e volta ao servidor.

Quando uma instrução ou lote de instruções Transact-SQL retorna vários conjuntos de linha como resultado, é possível que o número de colunas do conjunto de resultados seja alterado de um conjunto para o outro. SQLNumResultCols deve ser chamado para cada conjunto. Quando o número de colunas é alterado, o aplicativo deve associar novamente os valores de dados antes de buscar resultados de linha. Para obter mais informações sobre como manipular vários retornos de conjunto de resultados, consulte SQLMoreResults.

Melhorias no mecanismo de banco de dados desde o SQL Server 2012 permitem que SQLNumResultCols obtenha descrições mais precisas dos resultados esperados. Esses resultados mais precisos podem ser diferentes dos valores retornados por SQLNumResultCols em versões anteriores do SQL Server. Para obter mais informações, consulte Descoberta de metadados.

Consulte também

Conceitos

Detalhes de implementação da API ODBC

Outros recursos

Função SQLNumResultCols