SQLNumResultCols

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 causa uma viagem de ida e volta do servidor. Assim como SQLDescribeCol e SQLColAttribute, chamar SQLNumResultCols instruções preparadas, mas não executadas, gera uma viagem de ida e volta do servidor.

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

Melhorias no mecanismo de banco de dados a partir do 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 a Descoberta de Metadados.

Consulte Também

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