SQLNumResultCols

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Para instruções executadas, o driver ODBC do SQL Server Native Client não visita o servidor para relatar 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 Transact-SQL ou um lote de instruções retorna vários conjuntos de linhas de resultados, é possível que o número de colunas do conjunto de resultados seja alterado de um conjunto para 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 a partir do SQL Server 2012 (11.x) 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, veja Descoberta de metadados.

Confira também

Função SQLNumResultCols
Detalhes da implementação da API do ODBC